用途:该技能用于在遇到 TypeScript 的 any 类型、类型错误或宽松类型检查时,消除类型漏洞并强制严格类型安全。
主要能力:提供类型安全层级(接口/类型定义、带约束的泛型参数、联合类型、unknown + 类型守卫、never),覆盖错误处理、未知数据校验、模块增强、泛型约束、类型对齐等替换模式,并附带常见错误对照与 TSConfig 严格选项。
必要用法:把 catch(error: any) 改为 catch(error) 配合 instanceof 判断或 toError 辅助函数;把 JSON.parse(str) as any 改为 unknown 加类型守卫 isUserResponse;把 request as any 改为模块增强 declare module 'fastify';合并函数使用 function merge<T extends Record<string, unknown>, U extends Record<string, unknown>>(a: T, b: U): T & U。ESM 项目相对导入必须带 .js 扩展名,如 import { helper } from './utils.js',配合 module/moduleResolution 为 NodeNext 或 ESNext/bundler。审计流程:grep -r ": any|as any" --include="*.ts" src/ 查找、分类、定义类型、替换、构建 npm run build 验证、测试通过。
适用场景:函数参数或返回值含 : any、as any 断言、想忽略的类型错误、缺少类型定义的外部库、隐式 any 的 catch 块。
限制:不适用于已正确类型化的代码和第三方 .d.ts 文件(应向上游贡献)。若需要 as unknown as Type 双重断言,说明接口未对齐,应修复根因而非用双重断言掩盖。@ts-expect-error 仅在绝对必要时附带说明使用。具体价格、平台与效果资料暂未提供。