将JavaScript项目转为TypeScript时，如何高效处理大量类型错误？

一、通过TS配置隔离旧代码，聚焦新功能检查 #

• 批量标记旧文件跳过检查：在暂不处理的旧JS/TS文件顶部添加// @ts-nocheck注释，TypeScript会直接忽略整个文件的类型校验，快速压下所有旧错误。
• 精准控制检查范围：在tsconfig.json中，将新功能开发目录（如src/features/new/）加入include列表，旧代码目录暂时放入exclude，让TS只专注检查新写的代码。后续可以逐步将旧模块从exclude移回，分批处理。
• 新代码严格校验，旧代码宽松兼容：全局开启strict模式保证新代码的类型严谨性，同时启用skipLibCheck避免第三方库的类型错误干扰，旧文件用@ts-nocheck单独隔离。

二、错误快照对比，只关注新增错误 #

• 生成初始错误快照：执行tsc --noEmit > ts-errors-initial.log，将迁移初期的所有类型错误输出到日志文件，作为基准快照。
• 脚本过滤旧错误：写个简单的Node脚本，每次运行tsc --noEmit后，把当前错误和初始快照对比，按文件路径、行号、错误码匹配过滤，只输出快照中不存在的新错误。
• CI流程只查改动文件：用lint-staged配合TS检查，在CI中仅对本次提交改动的文件做类型校验，未改动的旧文件直接跳过，避免重复处理旧错误。

三、渐进式补全类型，降低单次工作量 #

• 临时用类型断言快速屏蔽错误：对旧代码中的变量先使用any或类型断言（如const data = response as User;）暂时跳过错误，后续再逐步替换为具体类型。
• 优先处理核心模块：先给业务核心、高频改动的旧模块补全类型，边缘模块暂时搁置，既减少后续维护的类型隐患，又不会一次性压垮开发节奏。
• JSDoc过渡无需改文件：在JS文件中添加JSDoc类型注释，比如/** @type {import('./types').User} */ const user = getUser();，TS能识别这些注释，不用立刻转.ts就能获得部分类型支持。

四、工具辅助减少手动工作量 #

• 用ts-migrate自动生成基础类型：这个工具可以扫描JS文件，自动添加类型注解并转成.ts文件，生成的类型可能多为any，但能快速减少初始错误数量，后续再手动优化。
• allowJs+checkJs渐进检查：先开启allowJs让TS识别JS文件，然后对需要处理的旧文件单独添加// @ts-check开启检查，其他旧文件保持不校验，逐步推进迁移。

内容的提问来源于stack exchange，提问作者Dobler