用途:该技能在用户提出优化 TypeScript 性能、加快 tsc 编译、配置 tsconfig.json、修复类型错误等需求时使用,提供一份覆盖 8 大类、共 42 条规则的性能优化指南,并按影响程度排序,用于指导自动化重构和代码生成。
主要能力:规则按优先级分为八类,并带有前缀标识。类型系统性能(type-,CRITICAL)涵盖为导出函数添加显式返回类型、避免深层嵌套泛型、避免大型联合类型、将条件类型提取为具名别名、限制类型递归深度、优先使用 interface 而非类型交叉、简化复杂映射类型。编译器配置(tscfg-,CRITICAL)涵盖正确配置 include/exclude、启用增量编译、skipLibCheck、strictFunctionTypes、isolatedModules,以及为大型代码库使用项目引用。异步模式(async-,HIGH)涵盖标注异步函数返回类型、避免循环内 await、避免不必要的 async/await、延迟 await、对独立操作使用 Promise.all。模块组织(module-,HIGH)涵盖避免 barrel 文件导入、避免循环依赖、控制 @types 包引入、对大型模块使用动态导入、对类型使用仅类型导入。类型安全模式(safety-,MEDIUM-HIGH)涵盖启用 strictNullChecks、优先用 unknown 而非 any、使用断言函数、const 断言、联合类型穷尽检查、类型守卫。内存管理(mem-,MEDIUM)涵盖避免闭包内存泄漏、全局状态累积、清理事件监听器与定时器、使用 WeakMap。运行时优化(runtime-,LOW-MEDIUM)与高级模式(advanced-,LOW)也有对应规则。
使用方式与适用场景:在配置新项目或既有项目的 tsconfig.json、编写复杂类型定义与泛型、优化异步与数据获取、组织模块与导入、审查编译或运行时性能等场景下参考这些指南。每条规则附带相对影响说明,便于按优先级应用。
限制:资料以规则清单形式给出,未提供具体代码示例、安装命令或直接可执行步骤;部分规则未提供完整的适用条件与例外说明。参考链接指向 TypeScript 官方性能文档、手册、V8 博客与 Node.js 内存诊断页面。