升级Angular到^12后出现zone.d.ts中无法重新声明块级变量'Zone'错误

该报错是Angular 12版本迭代后，zone.js类型声明和项目现有配置/依赖冲突导致的，可按照以下步骤逐一排查修复：

步骤1：清理并重新安装依赖 #

• 删除项目根目录下的node_modules文件夹、package-lock.json（npm用户）或yarn.lock（yarn用户）文件
• 执行依赖重装命令：
  npm用户执行npm install
  yarn用户执行yarn install

步骤2：修正tsconfig.json配置 #

• 打开项目根目录的tsconfig.json文件，找到compilerOptions配置项：
  • 检查types数组，确认没有重复声明zone.js相关的类型引用
  • 新增配置skipLibCheck: true，跳过第三方库文件的类型校验，可直接解决大部分库类型冲突问题

步骤3：校验zone.js版本匹配度 #

Angular 12要求zone.js版本最低为0.11.4，需确保版本匹配：

• 执行npm ls zone.js查看当前项目安装的所有zone.js版本
• 如果存在多版本共存的情况，固定zone.js版本：
  npm用户在package.json中新增overrides字段：

  "overrides": {
    "zone.js": "~0.11.4"
  }
  

  yarn用户在package.json中新增resolutions字段：

  "resolutions": {
    "zone.js": "~0.11.4"
  }
  

  配置完成后重新执行依赖安装即可。

步骤4：适配TypeScript版本 #

Angular 12仅支持TypeScript 4.2.x ~ 4.3.x版本，若你的TS版本不在此范围内，升级或降级到对应版本即可解决冲突。

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