npm全局安装报EACCES错误根本原因在于默认路径/usr/local/lib/node_modules权限受限，正确解法是执行npm config set prefix ~/.local并把~/.local/bin加入PATH，而非使用sudo。
绝大多数 Node 权限报错根本不是 VSCode 的问题，而是 npm 全局安装路径默认落在 /usr/local/lib/node_modules——这个目录普通用户没写权限。直接 sudo npm install -g 看似能跑通，但会污染系统、破坏 node_modules 权限链，后续 npm update 或 yarn 极易出连锁错误。
npm install -g 报 EACCES / Permission denied
这是 macOS 上最典型的权限现象，错误信息里一定包含 EACCES 和 /usr/local/lib/node_modules。它和 VSCode 无关，只和你当前终端的用户权限、npm 配置路径有关。
- 别用
sudo npm install -g—— npm 会以 root 身份执行任意preinstall脚本，可能删库或改系统配置 - 运行
npm config set prefix ~/.local，把全局模块装进用户目录 - 把
~/.local/bin加进$PATH：编辑~/.zshrc（macOS Catalina 及以后默认 shell 是 zsh），追加一行：export PATH=~/.local/bin:$PATH - 执行
source ~/.zshrc生效，再试npm install -g serve，会成功写入~/local/lib/node_modules
VSCode 终端里 which npm 返回 /opt/homebrew/bin/npm 但 node -v 失败
这说明终端环境没加载完整，常见于 VSCode 启动时未读取 ~/.zshrc。VSCode 的集成终端默认不加载 shell 的交互式配置文件（比如 alias、PATH 扩展），导致 npm 和 node 路径不一致。
- 检查
which node和which npm是否指向同一套 Node.js（比如都来自 Homebrew 或都来自官网 pkg） - 在 VSCode 终端里手动执行
source ~/.zshrc，再验证node -v - 更彻底的解法：在 VSCode 设置里搜索
terminal.integrated.shellArgs.osx，设为["-i"]（让 zsh 以交互模式启动，自动加载配置） - 如果用了 nvm，确保
~/.nvm/nvm.sh已在~/.zshrc中正确 source，且没有被return提前中断
Node.js 安装路径含空格或中文导致 require 报错
VSCode 调试器（js-debug）对路径编码极敏感。哪怕只是 /Applications/Visual Studio Code.app 这种带空格的路径，也可能触发 Cannot find module 错误；若 Node 安装在中文路径（如 /Users/张三/Downloads/node-v18.17.0-darwin-arm64），require() 会直接失败。
- 确认
which node输出路径是否纯英文、无空格、无中文字符 - 如果来自官网 pkg，默认装在
/usr/local/bin/node，没问题；如果手动解压到桌面或下载目录，务必挪到/usr/local或~/bin这类标准路径 - 检查
.vscode/launch.json中的runtimeExecutable字段：留空即可（靠 PATH 查找），不要填相对路径或带空格的绝对路径 - 重启 VSCode —— 路径变更后必须重启，否则调试器仍缓存旧路径
真正容易被忽略的是：VSCode 终端不会自动继承你 shell 的全部环境变量，尤其是 PATH 的增量部分。很多报错表面是“找不到 node”，实际是终端启动时 PATH 没加载全。与其反复 chmod 或 sudo，不如让 npm 走用户路径、让终端加载完整配置——这两步做完，95% 的权限类报错就消失了。
