安装tp最新版后注意啥 老项目想无缝过渡这几步别省
刚把TypeScript升到最新版,编译器报错一堆、构建脚本跑不通,折腾半天才理顺。下面把几个关键细节说清楚,帮你少踩坑。
tsconfig.json的字段变化最容易被忽略。新版把部分旧字段标记为deprecated但不会自动删除安装tp最新版后的注意事项,助你无缝过渡到新版本。,项目里还留着那些写法就会触发警告甚至报错。建议直接删掉已废弃字段,用新API替代。新版moduleResolution的默认值可能变了,如果项目依赖node16或bundler解析方式,记得手动确认,别等构建挂了才反应过来。

类型检查规则明显收紧。新版对泛型约束、条件类型的推导更严格,之前"碰巧通过"的类型现在直接报错。我遇到的典型情况是工具函数里的类型参数从any改成具体泛型,调用侧全得跟着调。遇到大面积报错先跑tsc --noEmit,把类型错误和运行时错误分开处理,效率会高很多。
构建工具和依赖兼容性得查一遍。Vite、Webpack、esbuild对TS版本绑定不同安装tp最新版后注意啥 老项目想无缝过渡这几步别省,升级前翻一下各工具changelog,看有没有"需TS≥某版本"的说明。node_modules里如果有包自带旧版typescript,可能产生版本冲突,用pnpm或yarn的resolve机制统一版本。
CI/CD流水线也别忘了。本地跑通不代表远程构建没问题,CI环境的Node版本、缓存策略可能和开发机不同。我上次本地升级完没问题,推到GitHub Actions上缓存了旧版TS,直接构建失败。升级后先清掉CI缓存重新跑完整流水线,确认所有stage都绿再合主分支。