Angular执行ng new无法创建项目：tsickle依赖问题

报错核心逻辑 #

该报错本质是npm 7.5.0默认启用的严格peer依赖校验规则触发的拦截：项目默认安装的typescript@4.1.3满足Angular核心生态包的peer版本要求，但依赖链上作为peerOptional存在的tsickle@0.39.1，声明的typescript版本要求为~3.9.5，和当前安装的TypeScript版本存在声明差。在npm 6版本中，这类可选依赖的版本差不会阻断安装流程，但npm 7+的严格校验会直接中断依赖树解析，抛出ERESOLVE无法解析依赖树的错误。

关于Angular的依赖组合逻辑：tsickle仅在执行Angular类库打包场景下会被实际调用，属于非核心的可选工具。Angular 11.1.x版本发布时，完成TypeScript 4.x适配的tsickle 0.40.0尚未同步更新到ng-packagr的peer依赖版本声明中，版本同步的时间差才导致了冲突提示，并非官方的配置错误。

可落地的解决步骤 #

• 方案一：启用兼容旧版npm逻辑的安装参数
  1. 先执行带跳过自动npm安装参数的项目创建命令，仅生成项目基础结构文件：
     ng new angular-demo --skip-npm
  2. 进入项目根目录后，执行带legacy-peer-deps参数的依赖安装命令：
     npm install --legacy-peer-deps
     该方案不需要调整本地Node、npm版本，跳过严格peer校验后，tsickle的版本声明差不会影响Angular应用的本地开发、生产构建流程。
• 方案二：将本地npm版本降级到Angular 11的适配基线
  Angular 11.1.x的官方适配基线对应npm 6.14.x版本，可执行命令全局安装对应兼容版本的npm：
  npm install -g npm@6.14.11
  完成版本调整后重新执行ng new angular-demo，即可自动走兼容的依赖解析逻辑完成安装。
• 方案三：通过overrides配置强制匹配兼容依赖
  项目文件生成完成后，打开项目根目录的package.json，在顶层新增overrides配置，强制拉取支持TypeScript 4.x的tsickle版本：

  "overrides": {
    "tsickle": "0.40.0"
  }
  

  保存配置后再执行常规npm install即可完成依赖解析，该方案不需要关闭全局peer校验规则，适配需要严格管控依赖版本的开发场景。

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