使用ng new创建Angular项目时遭遇npm依赖树解析错误

问题概述 #

执行ng new appt创建Angular项目，选择CSS样式表格式并启用SSR和SSG后，npm安装阶段触发ERESOLVE错误，无法解析依赖树。核心冲突为：

• 根项目声明的@angular/common@"^17.0.0"状态显示为undefined
• @angular/forms@17.0.8要求peer依赖@angular/common@"17.0.8"，二者版本不匹配导致冲突

可行解决方案 #

1. 清理缓存后重新安装 #

先清除npm缓存，删除已生成的依赖文件，再重新执行安装：

npm cache clean --force
rm -rf node_modules package-lock.json
# Windows系统执行：
# rmdir /s /q node_modules && del package-lock.json
npm install

2. 手动统一Angular核心依赖版本 #

编辑项目根目录的package.json，将所有@angular/*相关依赖的版本统一为17.0.8（匹配@angular/forms的peer依赖要求）：
修改示例：

// 原依赖
"@angular/common": "^17.0.0",
"@angular/core": "^17.0.0",
"@angular/forms": "^17.0.0",

// 修改后
"@angular/common": "17.0.8",
"@angular/core": "17.0.8",
"@angular/forms": "17.0.8",
// 确保其余@angular/*包版本也同步为17.0.8

修改完成后执行：

npm install

3. 临时跳过peer依赖检查（应急方案） #

若上述方法无效，可使用--legacy-peer-deps参数强制跳过peer依赖解析：

npm install --legacy-peer-deps

注意：此为临时 workaround，长期建议统一依赖版本以避免兼容性隐患。

4. 更新Angular CLI后重新创建项目 #

CLI版本与依赖版本不匹配可能引发此类问题，先更新CLI到最新稳定版：

npm install -g @angular/cli@latest

再重新创建项目：

ng new appt --style css --ssr --prerender

核心错误日志片段 #

npm ERR! ERESOLVE could not resolve
npm ERR!
npm ERR! While resolving: appt@0.0.0
npm ERR! Found: @angular/common@undefined
npm ERR! node_modules/@angular/common
npm ERR! @angular/common@"^17.0.0" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/common@"17.0.8" from @angular/forms@17.0.8
npm ERR! node_modules/@angular/forms
npm ERR! @angular/forms@"^17.0.0" from the root project

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