macos中npm全局安装报eacces错误，应重定向全局路径至用户目录（如~/npm-global），配置prefix并更新path；或改用nvm管理node.js，天然规避权限问题。

在 macOS 的 Node.js 环境中，npm 全局安装包（如 npm install -g yarn）时若遇到 EACCES 权限错误，本质是 npm 默认将全局模块写入系统级目录（如 /usr/local/lib/node_modules），而当前用户无写入权限。直接用 sudo npm install -g 虽能绕过，但会引发后续权限混乱、包管理异常甚至安全风险。正确做法是重定向 npm 全局路径到用户可写目录，并更新环境变量。

确认当前 npm 全局路径与权限问题

运行以下命令检查 npm 当前全局安装位置及是否可写：

npm config get prefix
ls -la $(npm config get prefix)/lib/node_modules

若输出显示路径为 /usr/local 且提示 Permission denied，说明权限冲突已存在。也可通过尝试安装一个轻量包验证：npm install -g serve，报 EACCES 即确认问题。

创建用户级全局目录并配置 npm

选择一个你拥有完全控制权的路径（推荐 ~/npm-global），并让 npm 使用它：

• 创建目录：mkdir -p ~/npm-global
• 设置 npm 使用该路径：npm config set prefix '~/npm-global'
• 将该目录下的 bin 加入系统 PATH（需编辑 shell 配置文件）

根据你使用的终端 shell（zsh 是 macOS Catalina 及之后默认），执行对应操作：

• zsh 用户：在 ~/.zshrc 末尾添加 export PATH="$HOME/npm-global/bin:$PATH"
• bash 用户：在 ~/.bash_profile 或 ~/.bashrc 中添加相同行

保存后运行 source ~/.zshrc（或对应文件）使配置生效。

验证配置并迁移已有全局包（可选）

执行以下命令确认新路径已生效：

npm config get prefix
which serve  # 若之前装过，现在应指向 ~/npm-global/bin/serve

若此前用 sudo 安装过全局包，建议清理旧路径残留并重新安装，避免混用：

• 查看旧全局包列表：sudo ls /usr/local/lib/node_modules
• 卸载（谨慎）：sudo npm uninstall -g <package-name></package-name>
• 重新安装（无需 sudo）：npm install -g <package-name></package-name>

常见工具如 yarn、typescript、http-server 均适用此方式。

补充：使用 nvm 可彻底规避权限问题

如果你尚未固定 Node.js 版本，更推荐用 nvm 管理 Node.js。nvm 默认将全局模块安装到用户目录（如 ~/.nvm/versions/node/v18.18.2/lib/node_modules），天然免权限问题，且支持多版本切换。安装 nvm 后，所有 npm install -g 操作自动在用户空间完成，无需额外配置路径。