TypeScript 官方文档翻译站点

一、网站简介

TypeScript 官方文档（www.typescriptlang.org/docs）是微软开发的强类型 JavaScript 超集 TypeScript 的权威学习与参考中心。它提供了从基础类型、接口和泛型到高级类型体操、编译配置和声明文件编写的完整学习体系，是现代 Web 全栈开发者的必备技能参考。

二、公司背景

TypeScript 由微软首席架构师 Anders Hejlsberg（C# 和 Turbo Pascal 之父）主导开发，于 2012 年首次公开亮相。凭借为 JavaScript 增加静态类型检查的核心能力，TypeScript 迅速成长为全球最受欢迎的编程语言之一。它被 Angular、Deno、VS Code（本身就用 TypeScript 编写）等大型项目采用，也是 Node.js 后端开发的主流语言选择。

三、核心功能

• 入门手册（Handbook）：从基础类型（string/number/boolean/array/tuple/enum）开始，逐步深入到接口、类、函数、泛型、枚举和模块等核心概念，是 TypeScript 学习的最佳起点。
• 类型体操进阶（Type Manipulation）：深入讲解泛型约束、条件类型（Conditional Types）、映射类型（Mapped Types）、模板字面量类型（Template Literal Types）和 infer 关键字等高级类型操作。
• tsconfig 配置参考：完整列出 tsconfig.json 中所有编译选项的含义、默认值和适用场景，包括 strict 模式、模块解析策略、目标版本等关键配置。
• 声明文件（Declaration Files）指南：介绍如何为已有的 JavaScript 库编写 .d.ts 类型声明文件，以及如何发布到 DefinitelyTyped 社区类型仓库。
• 实用工具类型参考：列出 Partial、Required、Pick、Omit、Record、ReturnType 等内置工具类型的用法和实现原理。
• 模块解析文档：详细解释 Node.js 模块解析策略（Classic 和 Node）以及 ESM/CJS 模块互操作的注意事项。

四、网站特点

• 交互式 Playground：内置 TypeScript Playground，支持在浏览器中编写 TypeScript 代码并实时查看编译后的 JavaScript 输出和类型错误提示。
• 中文支持优秀：官方文档提供完整的社区维护中文翻译版本，国内开发者可以直接访问 TypeScript 中文文档网站。
• 实用工具类型速查：Utility Types 页面是日常开发中最常被查阅的章节，提供了所有内置工具类型的简明示例。
• 与 VS Code 深度融合：文档中大量示例和概念与 VS Code 的 TypeScript 支持功能一一对应，学习效率极高。

五、适用人群

• 前端开发者：在 React、Vue、Angular 项目中使用 TypeScript 编写类型安全的组件和状态管理代码。
• Node.js 后端开发者：用 TypeScript 替代 JavaScript 编写后端服务，享受编译时类型检查带来的可靠性提升。
• 库/框架作者：为开源项目编写高质量的类型声明和 API 设计，提升开发者的使用体验。
• 从 JavaScript 迁移的开发者：通过 TypeScript 的类型系统逐步提升代码质量，文档的迁移指南提供了渐进式采用的策略。

六、应用场景

• React 项目开发：使用 TypeScript 为 React 组件的 Props 和 State 定义接口，利用泛型封装通用的 Hook 和工具函数，减少运行时类型错误。
• Node.js 后端服务：使用 TypeScript + Express/Fastify 构建类型安全的 REST API，配合 ts-node 或 tsx 直接运行 TypeScript 源码。
• 跨平台库开发：编写 TypeScript 库并生成 .d.ts 类型声明文件，发布到 npm，让 JavaScript 和 TypeScript 用户都能获得良好的类型提示体验。
• 大型项目重构：将已有的 JavaScript 项目逐步迁移到 TypeScript，通过宽松的 tsconfig 配置先让项目跑起来，再逐步启用 strict 模式。

七、常见问题（FAQ）

Q：国内能否直接访问？
A：可以。www.typescriptlang.org 在国内网络环境下可以正常直接访问。官方中文文档站点也可直接访问。

Q：TypeScript 和 JavaScript 是什么关系？
A：TypeScript 是 JavaScript 的“超集”，意味着所有合法的 JavaScript 代码都是合法的 TypeScript 代码。TypeScript 在 JavaScript 之上增加了可选的静态类型系统、接口、泛型等特性，编译后输出纯 JavaScript 代码，可以运行在任何支持 JavaScript 的环境中。

Q：TypeScript 编译后的代码体积会变大吗？
A：不会。TypeScript 的类型注解和接口在编译时会被完全擦除，输出的 JavaScript 代码与手写的 JavaScript 代码体积和性能一致。TypeScript 不引入任何运行时开销。

Q：如何在项目中渐进式采用 TypeScript？
A：可以通过将 .js 文件重命名为 .ts 并设置 tsconfig.json 中的 strict: false 开始，逐步修复类型错误后再启用严格模式。同时可以通过 allowJs 选项让 TypeScript 和 JavaScript 文件在同一项目中并存，文档中有专门的迁移指南详细说明渐进式采用策略。

八、类似网站

• Flow 官方文档：Facebook 推出的 JavaScript 静态类型检查器，TypeScript 的早期竞争对手。
• JSDoc 类型文档：通过 JSDoc 注释为 JavaScript 代码添加类型信息，TypeScript 也支持从 JSDoc 推断类型。
• ReScript 官方文档：一种编译到 JavaScript 的强类型语言，提供比 TypeScript 更彻底的函数式编程体验。