如何在VSCode中解决Node环境权限不足

VSCode 里跑 Node 脚本，90% 的时候报错都不是因为“权限不够”，而是 PowerShell 的执行策略或者 npm 的全局路径配置没搞对。很多人一上来就右键“以管理员身份运行” VSCode，或者在终端里敲 sudo npm install -g，这其实是在给自己埋雷，后患无穷。

别急着提权，先看看这两个最常见的坑。

PowerShell 执行策略拦截 .ps1 脚本

你在终端里执行 npm start 或者双击运行 build.ps1，结果蹦出来一句：“File build.ps1 cannot be loaded because running scripts is disabled”。这不是 Node 没装好，也不是文件权限不够，纯粹是 Windows 默认禁止本地脚本执行。解决办法很简单：

• 在 VSCode 终端里直接敲一行命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（注意，完全不需要管理员权限）
• 验证一下是否生效：Get-ExecutionPolicy -Scope CurrentUser 返回 RemoteSigned 就对了
• 这里有个容易踩的坑：改完策略后，必须关闭所有已打开的终端面板（Ctrl+Shift+` 全部关掉），再重新打开一个新终端。旧终端不会自动刷新策略，你改了也白改。
• 别为了省事直接设成 Unrestricted 或 Bypass，尤其在公司电脑上，组策略分分钟给你覆盖重置，到时候更麻烦。

npm install -g 报 EACCES / Permission denied

错误信息里出现 /usr/local/lib/node_modules（macOS/Linux）或 C:Program Filesnodejsnode_modules（Windows），说明 npm 正试图往系统级目录写文件，而普通用户当然没权限。这不是 VSCode 的锅，是 npm 默认配置路径太激进。

• macOS/Linux 用户：运行 npm config set prefix ~/.local，然后把 ~/.local/bin 加到 $PATH 里（修改 ~/.zshrc 或 ~/.bashrc）
• Windows 用户：运行 npm config set prefix %USERPROFILE%AppDataRoamingnpm，并确认该路径已在系统 PATH 中
• 配置完之后，所有 npm install -g 都会写入用户目录，不会再触发拦截
• 切记：绝对不要在 VSCode 终端里敲 sudo npm install -g。npm 会以 root 身份执行任意 preinstall 脚本，这风险极高，等于把系统钥匙交给了一个陌生人。

VSCode 终端里 node -v 失败但 which npm 有输出

这个现象比较诡异：which npm 能正常输出路径，但 node -v 却报错。这说明终端环境没加载完整，常见于 VSCode 启动时未读取 shell 配置文件（比如 ~/.zshrc），导致 node 和 npm 路径不一致，甚至找不到 node。

• 首先检查 which node 和 which npm 是否指向同一套 Node.js（比如都来自 Homebrew 或官网 pkg）
• 在 VSCode 终端里手动执行 source ~/.zshrc（macOS）或 source ~/.bashrc（Linux），再试 node -v，如果恢复正常，说明问题就在这
• 更彻底的解法：在 VSCode 设置里搜 terminal.integrated.shellArgs.osx（macOS）或对应 Linux 项，设为 ["-i"]，让 shell 以交互模式启动，自动加载配置
• 如果你用了 nvm，记得确保 ~/.nvm/nvm.sh 已在 ~/.zshrc 中正确 source，且没有被 return 提前中断。很多人就是因为这个被坑了。

Node 安装路径含空格或中文导致 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 这类标准路径
• WSL 用户注意：/mnt/c/ 下的 Node 安装包可能因 NTFS 权限缺失导致模块加载异常，优先移至 ~/ 原生路径

真正容易被忽略的是：VSCode 终端的权限上下文是“继承式”的——它不是独立沙盒。一旦你误用 sudo code 或管理员快捷方式启动过一次，后续生成的 .vscode/ 目录、node_modules、甚至调试缓存都可能被 root 写入，普通用户再打开项目就会连锁报错。修复比预防难得多，所以一开始就按正确的方式配置，比事后折腾要省心一百倍。