Angular 4执行ng build --prod时出现元数据版本不匹配错误

API 探路者

2026-5-26

解决Angular 4执行ng build --prod时元数据版本不匹配的问题

嘿，我碰到过这个问题！你这是Angular版本和第三方库ng-sidebar的兼容性冲突导致的——你的Angular 4只支持元数据版本3，但当前安装的ng-sidebar已经升级到适配更高Angular版本（比如Angular 5+）的版本，它的元数据版本是4，所以构建时就出现了不匹配的报错。给你几个靠谱的解决办法：

降级ng-sidebar到兼容Angular 4的版本
首先卸载当前的高版本：
```
npm uninstall ng-sidebar --save
```
然后安装专门适配Angular 4的ng-sidebar v7.x.x系列版本（这个版本区间是官方明确支持Angular 4-6的），比如选一个稳定的版本：
```
npm install ng-sidebar@7.2.0 --save
```
清理缓存并重新构建
有时候项目缓存会残留旧版本的信息，导致问题迟迟无法解决，执行下面的步骤彻底清理后再构建：
```
npm cache clean --force
rm -rf node_modules
rm package-lock.json
npm install
ng build --prod
```
（如果是Windows系统，把rm命令换成del，或者手动删除node_modules文件夹和package-lock.json文件）
检查并升级@angular/cli到适配Angular 4的稳定版本
你当前用的@angular/cli 1.1.2虽然适配Angular 4，但1.7.x版本是Angular 4对应的更稳定的cli版本，尝试升级看看：
```
npm install @angular/cli@1.7.4 --save-dev
```
升级完成后再执行ng build --prod试试。