如何解决Angular 18构建时的Symbol(patchedReferencedAliases)未定义错误？

问题背景 #

• 环境配置：Node.js 20.17.0，Angular CLI 18.2.3
• 异常现象：项目本地ng serve可正常运行，但执行ng build时触发编译失败，甚至今年7月曾正常运行的旧代码版本也出现相同错误
• 具体报错：

X [ERROR] Angular compilation emit failed. [plugin angular-compiler]
TypeError: Cannot read properties of undefined (reading 'Symbol(patchedReferencedAliases)')
at loadIsReferencedAliasDeclarationPatch (file:///C:/Users/james/aProject/A30Insurance/node_modules/@angular/compiler-cli/bundles/chunk-WYWH4ABE.js:1507:49)

解决建议 #

1. 降级Angular版本（按你计划的16.x版本操作） #

• 全局卸载当前Angular CLI：

  npm uninstall -g @angular/cli
  

• 安装Angular 16.x稳定版：

  npm install -g @angular/cli@16
  

• 进入项目目录，同步项目依赖版本：

  npm install @angular/cli@16 @angular/core@16 @angular/compiler-cli@16 --save-exact
  

• 清理缓存与旧依赖：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

• 尝试重新编译：ng build

2. 调整Node.js版本 #

Angular 18官方推荐Node.js 18.19+、20.10+、22+，你的20.17.0虽在范围内，但可尝试切换版本排查：

• 用nvm切换到18.x LTS版本：

  nvm install 18.20.4
  nvm use 18.20.4
  

• 重新安装依赖后执行ng build

3. 彻底清理编译缓存与依赖 #

• 清理Angular本地缓存：

  ng cache clean
  

• 删除旧依赖、锁文件与编译产物：

  rm -rf node_modules package-lock.json dist
  

• 重新安装依赖并强制无缓存编译：

  npm install
  ng build --no-cache
  

4. 排查依赖版本冲突 #

• 检查package.json中@angular/compiler-cli、@angular/compiler版本是否与@angular/core完全一致，若不一致，手动修改后重新安装依赖
• 临时移除项目中的第三方依赖（尤其是代码生成、编译相关插件），逐步排查是否存在兼容性问题

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