合并分支后执行yarn tsc出现已不存在的TypeScript报错如何解决

问题根因 #

• 增量编译缓存残留：TypeScript执行增量校验时会在项目根目录生成.tsbuildinfo缓存文件，你之前在master分支执行过yarn tsc生成的缓存未被清理，合并后执行校验时优先读取了缓存中master分支的错误结果，和当前实际代码不一致。
• 合并操作残留未跟踪文件：选择保留当前分支变更时，可能存在master分支的TS文件、类型声明文件未被完全覆盖，这类文件没有纳入git跟踪范围，git status不会展示，但TypeScript会默认扫描全工作区的TS文件，触发对应错误。
• tsconfig包含范围过宽：如果tsconfig.json中include字段配置的扫描范围过宽（例如**/*），会扫描到git合并过程生成的临时文件（例如.merge_file_xxxx格式的临时合并文件），这类文件保留了master分支的错误代码。

解决步骤 #

1. 清理TypeScript增量缓存
   执行命令清除官方缓存：
   yarn tsc --build --clean
   手动删除项目根目录下的.tsbuildinfo文件，确保无残留缓存。
2. 清理工作区残留文件
   执行git命令删除所有未被git跟踪的文件和文件夹（执行前请备份本地私有配置文件，例如.env.local等，避免误删）：
   git clean -fd
   执行git status确认工作区仅存在预期的合并后代码文件。
3. 执行全量类型校验
   强制关闭增量缓存执行全量校验，确认错误是否消除：
   yarn tsc --noEmit --incremental false
4. 调整tsconfig过滤规则
   如果问题仍存在，修改tsconfig.json的exclude字段，过滤不需要扫描的路径和临时文件，参考配置：

{
  "exclude": [
    "node_modules",
    "build",
    "dist",
    "**/*.merge_file_*",
    "**/.git/*",
    "**/.*"
  ]
}

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