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 写入，普通用户再打开项目就会连锁报错。修复比预防难得多，所以一开始就按正确的方式配置，比事后折腾要省心一百倍。
