next-forge
TypeScript 5 升级到 6 的完整迁移指南:ESM 优先模块系统变化、废弃 API 处理、新严格类型检查规则,以及大型代码库的分步迁移策略。
TypeScript 6 带来了多项破坏性变更,其中最重要的是对模块系统的调整和部分旧语法的废弃,迁移前需要充分了解影响范围。
baseUrl 配置项在 TypeScript 6 中正式废弃,推荐改用 paths 配合根路径别名,或使用 imports 字段进行包内路径映射,避免依赖隐式路径解析。
装饰器(Decorators)语法在 TypeScript 6 中进一步规范化,与 ECMAScript 标准对齐,旧版 experimentalDecorators 模式的行为可能有所不同,需要测试。
类型推断引擎在 TypeScript 6 中得到重大优化,大型项目的类型检查速度可提升 20-30%,同时对复杂泛型的推断也更加准确。
建议在迁移前先升级到 TypeScript 5 最新版并修复所有警告,再逐步升级到 6,利用 --allowJs 和严格模式配置分阶段推进。