SuperAPI AI 工具集

typescript

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:这是 Google 官方 TypeScript 编码标准的技能,用于编写一致、可维护的 TypeScript 代码,适用于新代码编写、既有代码重构、代码评审、配置 lint 规则以及团队新人上手。

主要能力(黄金规则):启用 tsconfig 的 strict 模式;对象形状优先用 interface 而非 type alias;禁止 any,真正未知时用 unknown;默认 const,需要重新赋值时用 let,不用 var;避免非空断言 !,显式处理可空性;公开函数与方法写显式返回类型;不应变更的属性用 readonly。

命名约定:类与接口用 UpperCamelCase(如 UserService、User);函数与方法用 lowerCamelCase(如 getUserById);变量用 lowerCamelCase(如 userCount);常量用 UPPER_SNAKE_CASE(如 MAX_SIZE);枚举用 UpperCamelCase(如 Direction),枚举成员用 UPPER_SNAKE_CASE 或 UpperCamelCase;文件用 lower-kebab-case(如 user-service.ts),测试文件为 lower-kebab-case_test(如 user-service_test.ts)。

类型与用法:interface 用于对象形状,type alias 用于联合类型。使用 unknown 后再做类型收窄,例如 typeof 判断后处理。可空性显式表达为 User | undefined,并用 if (user !== undefined) 判断,不用 !。公开 API 写显式返回类型;回调用箭头函数;可选参数可用默认值。导入使用具名导出与 type-only 导入(import type),禁止通配符导入。

tsconfig 推荐设置:strict、noImplicitAny、strictNullChecks、noImplicitReturns、noFallthroughCasesInSwitch、esModuleInterop、skipLibCheck 均为 true。

常见错误:用 any、用非空断言、用 var、缺少返回类型、通配符导入、类属性可变、对象用 type alias,均给出正确替代做法。

安装:npx skills add testdino-hq/google-styleguides-skills/typescript

限制:资料未提供该技能的收费、价格、平台兼容性或效果数据;完整细节、示例与边缘情况见 typescript.md。