npm 不加 sudo 就报权限错误，怎么解决？

npm 全局安装要 sudo 是目录权限问题，根治方法是把 npm 全局目录改到用户家目录（npm config set prefix），或用 nvm 管理 Node。不要用 sudo 装包。本文给出完整修复步骤。

观测云编辑部 2026-09-28 3 分钟阅读更新于 2026-09-28

别用 sudo 装 npm 包——这会让 root 拥有你目录里的文件，越用越乱。正确做法是把全局安装目录改到你自己拥有的位置。

# 1. 建一个属于你自己的全局目录
mkdir ~/.npm-global

# 2. 让 npm 用它
npm config set prefix "$HOME/.npm-global"

# 3. 把它的 bin 加进 PATH（写进 ~/.bashrc 或 ~/.zshrc）
export PATH="$HOME/.npm-global/bin:$PATH"

# 4. 重开终端或 source ~/.bashrc，之后全局安装不再需要 sudo
npm install -g typescript

善后：修复被 sudo 污染的文件

如果之前用 sudo 装过包，部分文件已被 root 拥有，会导致后续普通操作报 EACCES：

# 先核实 npm config get cache / prefix 及文件属主；只修复确认属于本用户的路径
# 不对共享目录、系统路径或整个项目盲目递归 chown

更省心的方案：用 nvm 管理 Node

用 nvm（Node Version Manager）安装的 Node，全局目录天然在家目录下，通常避免全局包目录的管理员权限需求，但项目/缓存权限仍需正确；使用 nvm 时需移除冲突的 npm 自定义 prefix，还能随时切换 Node 版本：

# 按 nvm 官方安装说明下载并审阅安装脚本后执行
# 安装并加载 nvm 后：
nvm install --lts

Windows 对应工具是 nvm-windows 或 fnm。

为什么 sudo npm 是坏习惯

提权安装扩大风险，生命周期脚本的具体运行身份取决于 npm 版本与目录属主，不能一概认为总是 root，恶意包的破坏力拉满；
root 创建的文件混进你的缓存目录，之后普通权限操作频频 EACCES；
CI/部署环境与本地权限模型不一致，埋坑。

常见问题（FAQ）

Q：项目内 npm install（不加 -g）也要 sudo 吗？
不需要也不应该。项目依赖装进项目目录的 node_modules，只要你拥有项目目录即可。如果报权限错，检查是不是之前用 sudo 跑过导致 node_modules 被 root 拥有：先检查 node_modules、缓存及父目录属主，只修正确认需要的路径，不要对项目根目录盲目递归 chown。

Q：公司电脑没有管理员权限能装 Node 吗？
在公司策略允许、依赖工具已具备时，可用用户目录的版本管理器或官方二进制；终端管理策略和安装前置条件仍可能需要管理员协助。

Q：改完 prefix 后全局命令找不到了？
确认 ~/.npm-global/bin 已加入 PATH 且终端已重开；用 npm config get prefix 核对配置生效。