npm eacces权限错误源于普通用户无权写入系统目录（如/usr/local/lib/node_modules），推荐方案是将全局路径改为~/.npm-global并更新path，避免sudo带来的安全隐患。
遇到 npm 报错别急着重装 Node，多数问题有明确归因和对应解法。关键不是“怎么跳过报错”，而是看懂它在告诉你什么。
权限不足（EACCES / EPERM）
这类错误常见于 macOS/Linux 全局安装时，系统阻止普通用户写入 /usr/local/lib/node_modules 等受保护目录。
- 不推荐长期用
sudo npm install -g，容易引发后续权限混乱 - 推荐改 npm 默认全局路径：
mkdir ~/.npm-global && npm config set prefix '~/.npm-global'
再把~/.npm-global/bin加进$PATH - 若已出现权限残留，可修复整个 node_modules 权限：
sudo chown -R $(whoami) ~/.npm-global
Peer dependency 冲突（ERESOLVE / unmet peer dependency）
这是 npm 7+ 的默认严格行为：当某个包声明了 peerDependencies（比如要求 React 18），而你项目里装的是 React 17，它就直接中断安装，不再像旧版那样只警告。
- 快速验证是否是 peer 问题：运行
npm ls react或npm ls eslint，看版本是否被多层嵌套或缺失 - 临时绕过（开发调试可用）：
npm install --legacy-peer-deps—— 恢复 npm 6 的宽松逻辑 - 更稳妥的解法是统一版本：要么升级插件（如
npm install eslint-config-react-app@latest），要么降级主依赖（如npm install react@18.2.0）
网络与缓存问题（ETIMEDOUT / ENOTFOUND / ECONNRESET）
这些看似是“包下载失败”，但根源常是源地址不可达、代理异常或本地缓存损坏。
- 先确认当前 registry：
npm config get registry，国内建议设为：npm config set registry https://registry.npmmirror.com - 清理缓存再试：
npm cache clean --force - 如果用了代理，检查是否启用：
npm config list | grep proxy，不需要时执行npm config delete proxy和npm config delete https-proxy
依赖树无法解析（unable to resolve dependency tree）
本质是多个包对同一依赖提出互斥要求，npm 找不到能同时满足所有条件的版本组合。
- 用
npm ls --depth=0查看顶层依赖，再用npm ls 包名看它被哪些子依赖拉入，定位冲突源头 - 删掉
node_modules和package-lock.json后重装，可强制重建干净依赖树 - 如需锁定某依赖版本（避免自动升级引发冲突），可在
package.json中写死："react": "18.2.0"（去掉^或~）
