无法将Spartacus添加到Angular项目中，请求技术帮助

我已按官方文档及相关指引操作，但安装始终无法完成。执行npm run ng add @spartacus/schematics@4命令时，持续出现以下错误：

C:\Tools\workspace\app-name>npm run ng add @spartacus/schematics@4

> app-name@0.0.0 ng C:\Tools\workspace\app-name
> ng "add" "@spartacus/schematics@4"

i Using package manager: npm
‼ Package has unmet peer dependencies. Adding the package may not succeed.

The package @spartacus/schematics@4 will be installed and executed.
Would you like to proceed? Yes
√ Packages successfully installed.
? Which Spartacus features would you like to set up?
Please note that for most Spartacus features to be properly configured, the Account feature is required. Assisted Services Module, Import/Export, Saved Cart, Quick Order, Checkout, Order, Product -
Variants, Product - Image Zoom, SmartEdit, Store Finder, Tracking - Personalization, User - Account, User - Profile
Must use import to load ES Module: C:\Tools\workspace\app-name\node_modules\@angular\compiler\fesm2015\compiler.mjs
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! app-name@0.0.0 ng: `ng "add" "@spartacus/schematics@4"`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the app-name@0.0.0 ng script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR!     C:\Users\M1088751\AppData\Roaming\npm-cache\_logs\2023-03-01T08_35_23_119Z-debug.log

问题根源 #

这个错误的核心是ES模块加载方式不兼容：@angular/compiler的.mjs文件要求使用import语法加载，但当前环境可能采用了CommonJS的require方式，或者Angular版本与Spartacus 4的兼容性不匹配导致。

解决方案 #

1. 匹配Angular与Spartacus版本

Spartacus 4.x强制要求Angular版本为12.x，先检查当前项目的Angular版本：

ng version

若版本不符，执行以下命令降级/升级到Angular 12：

npm install @angular/cli@12 @angular/core@12 @angular/common@12 @angular/compiler@12 @angular/platform-browser@12 @angular/platform-browser-dynamic@12 --save

2. 修复ES模块加载问题

• 确保Node.js版本为14.x（Spartacus 4官方推荐版本），过高版本易引发ES模块兼容性问题。
• 删除node_modules和package-lock.json，重新安装依赖：

rm -rf node_modules package-lock.json
npm install

• 跳过npm run，直接执行Angular CLI命令：

ng add @spartacus/schematics@4

3. 处理未满足的Peer依赖

安装前的unmet peer dependencies提示可通过两种方式解决：

• 手动安装缺失的依赖包（参考Spartacus 4官方文档的依赖列表）
• 临时使用--legacy-peer-deps参数绕过依赖检查（仅临时应急，不建议长期使用）：

npm install @spartacus/schematics@4 --legacy-peer-deps
ng add @spartacus/schematics@4

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