Angular项目安装select-country依赖失败报错问题咨询

算力阿峰

2026-8-30

Angular 安装 select-country 依赖失败排查与解决

按以下优先级逐一排查即可解决90%以上的安装失败问题：

先清理本地依赖环境，排除缓存、锁文件冲突问题
终止所有运行中的Angular本地服务、node进程后，在项目根目录执行以下命令：
```
# 删除现有依赖目录和锁文件
rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
# 清理npm本地缓存
npm cache clean --force
```
校验版本兼容性
先执行ng version确认当前项目使用的Angular大版本，select-country相关的Angular包（主流为ngx-select-country）对Angular版本有严格匹配要求：Angular 14+需安装3.x版本，Angular 12~13需安装2.x版本，Angular 11及以下需安装1.x版本，版本不匹配触发的peer依赖冲突是最常见的安装失败原因。确认版本后安装对应版本包即可，例如Angular 15环境执行：
```
npm install ngx-select-country@3.1.0 --save
```
排查权限与网络问题
- Windows用户如果提示EPERM权限错误，先关闭占用项目目录的杀毒软件、资源管理器窗口，用管理员身份启动终端后重试安装；Mac/Linux用户不要用sudo执行npm安装，先修正npm全局目录权限后再操作，避免后续权限混乱。
- 如果提示网络超时、SSL连接错误，先切换到稳定的npm源再重试：
```
npm config set registry https://registry.npmmirror.com
```
- 公司内网环境需要提前确认运维是否将该包加入内网npm源的同步白名单。
特殊场景处理
如果确认版本兼容但依然报peer依赖错误，可以在安装命令后加上--legacy-peer-deps参数跳过严格的依赖校验：
```
npm install ngx-select-country --save --legacy-peer-deps
```
注意：非必要不要加--force参数强制安装，强制安装大概率会导致项目启动阶段出现模块解析、依赖注入类的运行时错误。