Angular中@ng-bootstrap元数据版本不匹配问题求助

AI 小北

2026-5-15

解决Angular Metadata Version Mismatch（@ng-bootstrap/ng-bootstrap）问题

这个错误本质是你安装的@ng-bootstrap/ng-bootstrap版本和当前Angular项目的核心编译器版本不兼容——元数据版本4对应Angular 9+的编译器，而版本3对应Angular 8及更早版本。给你一步一步的排查和解决步骤：

第一步：确认你的Angular核心版本
在项目根目录运行命令：
```
ng version
```
重点看@angular/core的版本号，比如显示8.x.x就是Angular 8，9.x.x及以上就是Angular 9+。
第二步：安装对应兼容的ng-bootstrap版本
两者的兼容对应关系是：
- Angular 8及更低 → 使用ng-bootstrap 5.x版本（元数据版本3）
- Angular 9+ → 使用ng-bootstrap 6.x及以上版本（元数据版本4）
  操作示例：
  先卸载现有版本：
```
npm uninstall @ng-bootstrap/ng-bootstrap
```
然后安装对应版本，比如Angular 8的话：
```
npm install @ng-bootstrap/ng-bootstrap@5.3.0
```
Angular 9+的话直接装最新稳定版：
```
npm install @ng-bootstrap/ng-bootstrap@latest
```
第三步：清理依赖缓存（可选但推荐）
如果还是有问题，大概率是缓存或者依赖锁文件导致的版本不一致：
1. 删除node_modules文件夹和package-lock.json文件（Windows用户用对应命令）：
```
# macOS/Linux
rm -rf node_modules package-lock.json
# Windows
rmdir /s /q node_modules && del package-lock.json
```
2. 重新安装所有依赖：
```
npm install
```
额外检查
运行npm ls @angular/core，查看是否有子依赖偷偷引入了不同版本的Angular核心包，如果有，需要调整对应依赖的版本或者使用npm dedupe来合并重复依赖。