| name | typescript-dev |
| description | TypeScript 编码规则和最佳实践,包括类型系统、严格模式、泛型和工具类型使用 |
| metadata | {"audience":"maintainers","workflow":"github"} |
TypeScript 开发规范
何时使用
当你编写或审查 TypeScript 代码(*.ts、*.tsx、*.d.ts 文件)时使用此 skill。
代码规范
- 在
tsconfig.json 中启用严格模式(strict mode),以获得更全面的类型检查
- 对对象结构使用
interface,对联合类型(union)或交叉类型(intersection)使用 type
- 在可能的情况下利用类型推断(type inference),减少显式类型注解
- 使用泛型(generics)构建可复用的组件与函数
- 启用
strictNullChecks,防止 null 和 undefined 引发错误
- 使用泛型提升类型推断能力,增强组件的可复用性
- 优先使用类型守卫(type guards)进行运行时检查,尽量避免强制类型断言(
as)
- 避免使用
any 类型,不确定类型时优先使用 unknown 或泛型
- 熟练使用 TypeScript 工具类型(Utility Types,如
Pick, Omit, Partial)来转换类型
- 在终端运行命令时,默认使用
pnpm 作为包管理器