typescript-expert

TypeScript Expert - 类型级编程与性能优化专家

技能概述

TypeScript Expert 是一个专注于 TypeScript 和 JavaScript 开发的高级 AI 助手，擅长处理复杂类型编程、性能优化、Monorepo 管理和项目迁移等技术难题。

适用场景

复杂类型问题解决

当遇到 TypeScript 类型系统的高级用法时，如条件类型、模板字面量类型、递归类型、品牌类型等，本技能可以提供准确的类型定义和解决方案。

项目性能优化

当 TypeScript 类型检查速度变慢、构建时间过长时，本技能可以诊断性能瓶颈，提供 skipLibCheck、增量编译、项目引用等优化方案。

项目架构与迁移

规划新的 TypeScript 项目结构、将 JavaScript 项目迁移到 TypeScript、配置 Monorepo 的类型引用、选择合适的工具链（Biome vs ESLint、Nx vs Turborepo）等架构决策。

核心功能

类型级编程支持

支持高级类型系统特性，包括品牌类型（Branded Types）、条件类型、模板字面量类型、递归类型、类型推断技巧（satisfies、const 断言）等，帮助编写类型安全且优雅的代码。

性能诊断与优化

通过 tsc --extendedDiagnostics、traceResolution 等工具诊断类型检查性能问题，提供 skipLibCheck、incremental、项目引用等优化策略，解决"类型实例化过深"等常见错误。

现代工具链指导

涵盖 TypeScript 生态主流工具，包括 Biome vs ESLint 选择、Vitest 类型测试、ts-node/tsx 执行调试、项目引用配置、ESM/CJS 兼容性处理等实用技能。

常见问题

TypeScript 和 JavaScript 有什么区别？

TypeScript 是 JavaScript 的超集，添加了静态类型系统。主要优势包括：编译时类型检查减少运行时错误、更好的 IDE 智能提示、支持高级类型模式、便于大型项目维护。建议新项目、团队协作项目、需要长期维护的项目使用 TypeScript。

TypeScript 类型检查太慢怎么办？

常见解决方案包括：启用 skipLibCheck: true 跳过库文件类型检查、使用 incremental: true 增量编译、精确配置 include/exclude、在 Monorepo 中使用项目引用、避免过度复杂的类型（如深层递归）。可使用 npx tsc --extendedDiagnostics 诊断具体瓶颈。

如何将 JavaScript 项目迁移到 TypeScript？

推荐渐进式迁移策略：1) 在 tsconfig.json 中启用 allowJs 和 checkJs；2) 逐个将 .js 文件重命名为 .ts；3) 为每个文件添加类型注解；4) 逐步启用严格模式选项。可使用 ts-migrate、typesync 等工具辅助自动化迁移。