上个月接到一个老项目的维护需求,代码库还是 TypeScript 2.7 时代的写法,tslint 配置文件比业务代码还长,any 类型用得跟不要钱似的。我原本计划两周搞定,结果光是升级 TS 版本就折腾了快一周——各种废弃 API、类型报错、依赖冲突,改到怀疑人生。后来换了 VS Code 新出的这套 AI 升级工具,整个流程被压缩到了四天,而且大部分工作都是机器替我干的。借着这个项目,我把这套 JS/TS 自动化升级的方案完整梳理了一遍,今天分享出来。
这套工具解决的核心问题很直接:老项目里那些机械性的、重复性的升级工作,比如废弃 API 替换、语法迁移、类型补全、依赖版本对齐,全部交给 AI 来做。它不是帮你重写业务逻辑,而是像带了个熟悉整个 ECMAScript 和 TypeScript 演进历史的高级工程师,帮你把“升级”这件事从“高危操作”变成“可控流程”。适合所有手里攥着老项目、一直不敢动技术债的朋友,也适合刚接手历史代码、想快速摸清家底的开发者。
1. 为什么老项目的 JS/TS 升级这么让人头疼
1.1 老代码的真实状态:不是不能跑,而是不敢碰
我接手的那套系统,距今少说也有六七年了。第一眼看过去,代码还能跑,功能也正常,但整个工程处于一个非常尴尬的状态:package.json 里锁着 typescript@2.7.2,ESLint 还没普及,用的是已经停止维护的 TSLint,模块导入方式还是 import * as React from 'react' 这种老式写法,异步逻辑全是 Promise 链,连一个 async/await 都找不到。
最痛苦的是类型定义。整个项目几千个文件,any 的使用率估计能到 30% 以上。函数入参是 any,返回值是 any,接口定义里全是 [key: string]: any。表面上类型检查能过,但实际上类型系统形同虚设,你根本不知道一个函数会返回什么,只能靠运行时去猜。
这种代码不是“写出来的”,是“长出来的”——经历了多个版本迭代,每个开发者都在原有基础上打补丁。它的问题不在于单个文件有多烂,而在于文件之间的耦合关系像蜘蛛网一样密。你改一个公共工具函数的类型签名,能引发二十多处调用方的连锁报错。这种牵一发动全身的状态,让升级变成了一件“不值得做”的事。
1.2 手动升级的真实痛点:不是不会,而是量太大
很多人觉得升级不就是改几个语法吗?真正上手才知道,工作量完全不在一个量级。
第一类是废弃 API 的替换。比如 Node.js 从 util.promisify 到原生 Promise 的迁移,fs.exists 到 fs.access 的替换,request 库到 axios 或内置 fetch 的切换。这些 API 的废弃往往跨了好几个大版本,中间的迁移路径各不相同,你得自己去翻 changelog。最坑的是有些库的迁移不是一一对应的,而是“一个变两个”或者“两个并一个”,比如 url.parse 拆成了 new URL() 和 urlToHttpOptions,用错了编译都编译不过。
第二类是 TypeScript 版本升级带来的类型检查收紧。从 2.7 升到 3.x,再升到 4.x、5.x,每个大版本都会新增检查规则。最典型的是 strict 模式全面收紧,像 strictNullChecks 打开之后,整个项目里凭空多出来几千个“可能为 null 或 undefined”的报错。手动去补这些类型,一个文件可能要花掉半小时,纯纯的体力活。
第三类是依赖的连带升级。你要升级 TypeScript,就得同步升级 ts-loader 或者 @babel/preset-typescript;升级 React Router,就得跟着改路由写法;升级 Webpack,配置文件可能得重写。一个依赖的升级,往往牵出三四个关联升级,每个都有自己的一套 breaking changes。手动处理就是按葫芦浮起瓢
