SuperAPI AI 工具集

typescript

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:本技能整理 TypeScript 5.x 及以后(2025-2026 生态)的编码规范与最佳实践,帮助编写健壮、高性能、类型安全的 TS 代码,并指出生态趋势,如向基于 Go 的编译器(TS 7+)过渡带来的性能提升、strict: true 成为默认基线、TS 深度集成于 Next.js、Remix、NestJS 等框架。

主要能力与配置:给出 tsconfig.json 建议,包括 strict、noImplicitAny、strictNullChecks、strictFunctionTypes、strictBindCallApply、strictPropertyInitialization、noImplicitThis、useUnknownInCatchVariables、noUncheckedIndexedAccess、exactOptionalPropertyTypes 等类型安全选项,以及 module/moduleResolution 设为 NodeNext、target 设为 ES2022、skipLibCheck、esModuleInterop、forceConsistentCasingInFileNames、verbatimModuleSyntax、allowSyntheticDefaultImports 等模块与开发体验设置。

类型模式:倡导用 unknown 代替 any 并配合类型守卫收窄;用 satisfies(TS 4.9+)校验值匹配类型而不扩大类型、保留推断;默认使用 readonly 防止意外修改,尤其用于函数参数和 React props;用模板字面量类型(如 on${Capitalize<EventName>})提升补全与安全性。

性能与陷阱:建议用 import type 或 import { type ... } 显式类型导入,配合 verbatimModuleSyntax 在使用现代打包器时实现零 JS 开销;用 await import(...) 懒加载拆分代码。应避免过度使用 as 断言(改用类型守卫或 zod 校验)、过宽类型(避免 Function 和 object,改用 () => void 或 Record<string, unknown>)、滥用 enum(优先字符串联合类型)。参考资料包括 TypeScript 5.x 发布说明、Total TypeScript 与 Zod。具体安装命令与更多细节资料未提供。