DefinitelyTyped

项目简介

DefinitelyTyped 是 TypeScript 官方生态中的类型声明仓库，为大量没有内置类型的 JavaScript 库提供高质量的 .d.ts 声明文件，并以 @types/xxx 的形式发布到 npm。

核心用途

• 为第三方库补齐 TypeScript 类型，获得补全与静态检查
• 统一管理社区维护的类型声明，避免各库自行维护造成碎片化
• 作为学习声明文件写法的参考样例库

安装与使用

通常通过 npm 安装对应类型包：

npm install --save-dev @types/node

对于带作用域的包，需要去掉 @ 并在作用域后加双下划线，例如 @babel/preset-env 对应 @types/babel__preset-env。

在非模块环境下，可能需要显式引用：

/// <reference types="node" />

贡献方式

仓库采用 pnpm monorepo 结构，每个类型包位于 types/ 目录下。贡献流程大致为：

1. 在本地项目中实际使用并验证类型改动
2. 修改或新增对应 types/xxx/index.d.ts
3. 补充类型测试用例
4. 提交 PR，等待 CI 校验与维护者审核

仓库强调新增类型应源于真实使用需求，不接受无实际使用动机的批量提交。

注意事项

• 仓库只保证对近两年内 TypeScript 版本的测试支持
• 类型包体积与数量庞大，本地克隆和依赖安装需要一定时间
• 遇到类型问题可先在 TypeScript 社区 Discord 的 Definitely Typed 频道反馈