如何解决执行npm run build命令时出现的模块找不到错误

核心问题分析 #

从错误日志和package.json来看，有两个关键问题导致构建失败：

1. Node.js版本不兼容：当前使用的Node.js v16.17.0与Angular 11的支持版本不匹配（Angular 11官方推荐Node.js 12.x或14.x），且超出了项目声明的>=10.13范围，会引发依赖安装和命令执行异常。
2. Angular CLI版本与核心框架版本不匹配：项目依赖的Angular核心版本是11.1.0，但开发依赖里的@angular/cli是14.2.2，跨大版本的CLI会导致执行ng build时找不到对应模块。

具体修复步骤 #

1. 调整Node.js版本 #

建议切换到Node.js 14.x LTS版本（与Angular 11兼容），可以通过Node版本管理器（nvm）快速操作：

# 安装Node.js 14.x
nvm install 14
# 切换到该版本
nvm use 14

2. 修正Angular CLI版本 #

修改package.json的devDependencies字段，将@angular/cli版本改为与Angular核心一致的11.1.0：

"@angular/cli": "^11.1.0",

注：当前@angular-devkit/build-angular的版本0.1101.1与Angular 11.1.x匹配，无需修改。

3. 重新安装依赖 #

先清理现有依赖和锁文件，再重新安装：

# 删除本地依赖包和锁文件
rm -rf node_modules package-lock.json
# 重新安装所有依赖
npm install

如果安装时出现依赖冲突报错，可添加参数兼容老版本依赖：

npm install --legacy-peer-deps

4. 验证并执行构建 #

依赖安装完成后，先确认CLI版本匹配：

npx ng version

当输出的Angular相关版本均为11.1.x后，执行构建命令：

npm run build

前置依赖安装说明 #

执行npm run build前，只需运行npm install即可自动安装package.json中列出的所有生产依赖（dependencies）和开发依赖（devDependencies），无需手动单独安装某个包。

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