用途:在审查 TypeScript 代码时,按 Google TypeScript Style Guide 加团队约定进行风格、命名、导入与类型用法检查。完整规则见 google-ts-styleguide.md。
主要检查项:源文件结构(版权、@fileoverview、导入、实现顺序;仅具名导出,不用默认导出;使用 ES6 模块,不用 namespace 或 require();不用可变导出 export let);变量与字面量(默认 const、重赋值用 let、禁用 var;单个声明一个变量;字符串用单引号;拼接用模板字符串);类(只读属性用 readonly、参数属性、不用 public 关键字、不用 # 私有字段而用 private、不做原型操作);函数(具名函数用函数声明,回调与嵌套用箭头函数,不用 rest 参数替代 arguments);控制流与错误(控制块加花括号、用 === 与 !==,例外是 == null;数组用 for...of,不用 for...in;只抛 Error 实例;switch 必须有 default 且不允许穿透);命名(类型与组件用 UpperCamelCase、变量函数用 lowerCamelCase、常量用 CONSTANT_CASE、缩写视作单词);类型系统(对象形状优先 interface,用 unknown 而非 any,可选属性用 ?,禁用包装类型,禁用 @ts-ignore 与 @ts-nocheck);Schema 与类型定义(团队约定用 Zod 定义 schema 并以 z.infer 推导类型,非共享类型放在使用文件顶部,共享类型放共享 types/schemas 模块);注释与文档(公共 API 用 JSDoc,实现注释用 //,JSDoc 中不写类型注解,废弃代码标 @deprecated)。
使用方式与限制:资料未提供具体安装命令、运行方式、平台或收费信息;仅说明在审查代码时对照上述条目检查,完整规则与示例需查看 google-ts-styleguide.md。