用途
本资料是面向高级 TypeScript 的深度参考，目标是使用 TypeScript 5.9+ 构建企业级、类型安全的应用程序。适用于以下场景：构建类型安全的 React、NestJS 或 Node.js 应用；将 JavaScript 代码库迁移到 TypeScript；实现高级类型模式（泛型、映射类型、条件类型）；配置现代 TypeScript 工具链（Vite、pnpm、ESLint）；使用 Zod 校验设计类型安全的 API 契约；以及将 TypeScript 方案与 Java 或 Python 进行对比。
主要能力
资料以速查与模式示例的形式组织，覆盖以下内容：
- 快速开始：使用 pnpm 初始化带 ESM 的 TypeScript 项目，并给出严格 tsconfig 配置示例（target ES2024、module ESNext、moduleResolution bundler、strict、noUncheckedIndexedAccess、exactOptionalPropertyTypes、esModuleInterop、skipLibCheck）。
- 项目设置清单：使用 pnpm 管理包、ESM 优先（package.json 中 type: "module"）、开启严格模式、配置 @typescript-eslint、添加 Prettier、配置 Vitest。
- 类型系统速查：原始类型、联合与交叉类型、可辨识联合、类型守卫（typeof 与自定义类型守卫）、satisfies 操作符（TS 5.0+）。
- 泛型模式：基础泛型函数、约束泛型、泛型 API 响应包装器。
- 工具类型参考：Partial、Required、Pick、Omit、Record、ReturnType、Parameters、Awaited。
- 条件类型与映射类型：如提取数组元素类型、解包 Promise 类型、只读化、可空化，以及通过模板字面量类型生成 getter 函数名。
- 框架集成：React 的类型化函数组件与 hooks；NestJS 的类型安全 DTO，可通过 class-validator 或 Zod 实现。
- 使用 Zod 做校验：定义 schema、用 z.infer 推导类型、运行时 parse 与 safeParse。
- 现代工具链（2025）：列出 TypeScript 5.9+、Node.js 22 LTS、Vite 7.x、pnpm 9.x、ESLint 9.x、Vitest 3.x、Prettier 3.x 及其用途，并给出 ESLint 9+ Flat Config 示例。
- 迁移策略：增量迁移步骤（allowJs、checkJs、逐个重命名文件、逐步加注类型、逐步开启更严格选项）以及使用 JSDoc 进行渐进式类型标注。
- 常见错误：过度使用 any、忽略严格模式、滥用类型断言 as、为简单联合使用 enum、不校验 API 数据，并给出对应修复建议。
- 跨语言对比：TypeScript、Java、Python 在类型系统、可空性、泛型、接口、枚举方面的差异。
- 参考文件与资产：type-system.md、generics.md、enterprise-patterns.md、react-integration.md、nestjs-integration.md、toolchain.md，以及 tsconfig-template.json、eslint-template.js 和 validate-setup.sh。
使用方式
资料给出初始化的安装与配置命令：使用 pnpm create vite@latest my-app --template vanilla-ts 创建项目并安装依赖，然后创建 tsconfig.json 写入严格配置。项目开始前应按设置清单依次完成包管理、ESM、严格模式、ESLint、Prettier 与测试配置。具体的高级模式可参考对应的参考文件。
适用场景
适合需要类型安全的企业级前端或后端项目、从 JavaScript 向 TypeScript 迁移的团队、需要配置现代构建与校验工具链的开发者，以及希望对比 TypeScript 与其他语言类型系统的工程师。
限制
资料声明兼容 TypeScript 5.9+、Node.js 22 LTS、Vite 7、NestJS 11、React 19；版本之外的环境暂未提供说明。关于收费、价格、平台支持范围等内容暂未提供。