SuperAPI AI 工具集

typescript-migration

编程与开发

查看项目

更新于 10-15 20:35

技能介绍

用途:本技能用于把 JavaScript 项目(或其中一部分)逐步迁移到 TypeScript,面向需要渐进、不打断开发的遗留代码库。触发场景包括:用户想把 JS 项目转为 TS、为现有项目引入 TypeScript、为遗留代码补充类型或减少 any、设置混合 JS/TS 的 tsconfig。

主要能力:提供五阶段迁移法。阶段一配置:安装并设置 tsconfig,开启 allowJs、关闭 checkJs、strict 暂设为 false,可配合 Vite、Next.js、Webpack (ts-loader) 等构建工具。阶段二重命名:从依赖树叶子文件开始,逐个把 .js 改为 .ts,运行 npx tsc --noEmit 检查并修复类型错误。阶段三类型边界:为公共 API、共享接口、API 响应与事件消息负载定义类型,可放到 types 目录。阶段四收紧编译:依次开启 strictNullChecks、noImplicitAny、noImplicitReturns、noFallthroughCasesInSwitch,并用 unknown 加类型守卫或 Zod 消除 any。阶段五严格模式:全部文件转为 TS 后开启 strict 并关闭 allowJs。

使用方式:按上述阶段顺序执行,每步保持代码库可运行;每文件补充导出函数的参数与返回类型,避免 as any,测试先行验证,每次提交控制在单个文件或模块。

适用场景:遗留 JS 项目、混合 JS/TS 代码库、需要逐步提升类型安全的团队。

限制与注意:官方资料未提供具体价格、收费方式或平台信息;迁移需团队协作,不应在迁移中重写逻辑,也不应一开始就启用严格模式。