答案是修改PowerShell执行策略为RemoteSigned(当前用户作用域)并重启终端:一、运行get-ExecutionPolicy确认为Restricted;二、执行set-ExecutionPolicy RemoteSigned -Scope CurrentUser;三、用get-ExecutionPolicy -Scope CurrentUser验证;四、关闭所有终端后新建生效。

VSCode终端里运行Node.js程序报错,绝大多数情况根本不是“权限不足”,而是PowerShell执行策略拦截、环境变量没继承、脚本路径或权限配置错误——直接开管理员模式或敲sudo只会掩盖问题,还可能让npm preinstall脚本以root身份静默破坏系统。
PowerShell执行策略拦住npm start或.ps1脚本
Windows上VSCode默认终端是PowerShell,而它的默认策略Restricted会拒绝执行任何本地.ps1脚本(包括npm生成的包装脚本),错误信息通常是:File xxx.ps1 cannot be loaded because running scripts is disabled on this system。这不是文件权限问题,也不是Node没装好。
- 在VSCode终端中运行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser(无需管理员) - 验证是否生效:
Get-ExecutionPolicy -Scope CurrentUser应返回RemoteSigned - 必须关闭所有已打开的终端面板(Ctrl+Shift+`关掉全部),再新建一个——旧终端不会自动刷新策略
- 别用
Unrestricted或Bypass,尤其在公司设备上,组策略可能随时覆盖
node或npm命令找不到
VSCode终端启动时往往不加载完整的shell配置(比如~/.zshrc或PATH),导致node -v能跑但npm -v报错,或反之。这不是权限问题,是环境隔离。
- 先确认系统级路径:Windows运行
where node,macOS/Linux运行which node,确保输出合理 - 在VSCode终端里执行
echo $PATH(macOS/Linux)或echo %PATH%(Windows),对比系统终端输出,缺了关键路径就补 - macOS/Linux:在VSCode设置中把
terminal.integrated.shellArgs.osx设为["-l"](启用login shell) - Windows:在
settings.json里加"terminal.integrated.env.windows": {"PATH": "C:\Program Files\nodejs;${env:PATH}"},改完必须彻底退出VSCode再重开
npm install -g报EACCES或Permission denied
错误信息里出现/usr/local/lib/node_modules(macOS/Linux)或C:Program Files
odejs
ode_modules(Windows),说明npm正试图往系统级目录写文件——普通用户无权访问,这不是VSCode的问题,是npm默认路径太激进。
- macOS/Linux:运行
npm config set prefix ~/.local,再把~/.local/bin加进$PATH(改~/.zshrc,加export PATH=~/.local/bin:$PATH,然后source ~/.zshrc) - Windows:优先用
npm install --user(部分CLI支持),或运行npm config set prefix %USERPROFILE%AppDataRoaming pm,并确认该路径已在系统Path环境变量中 - 绝对不要在VSCode终端里敲
sudo npm install -g——npm会以root身份执行任意preinstall脚本,风险极高 - 验证:
npm config get prefix和which npm(或where npm)输出路径应一致且可写
WSL下./script.sh仍报Permission denied
在WSL里chmod +x deploy.sh做了,但child_process.spawn('./deploy.sh')还是失败?常见于脚本放在/mnt/c/这类NTFS挂载路径下——NTFS不支持POSIX权限位,chmod实际无效。
- 把项目移到WSL原生路径,例如
~/projects/my-app,再chmod +x deploy.sh - 检查shebang是否正确(如
#!/bin/bash),且换行符是LF(非CRLF),否则bash解析失败 - 若必须放
/mnt/c,需在/etc/wsl.conf里加[automount]段并设options="metadata",然后wsl --shutdown重启 - Node调用
exec('npm run build')报command not found?显式传入环境:exec('npm run build', { env: process.env })
真正卡住人的地方,从来不是“要不要改策略”,而是改了之后忘了关掉终端再新建;也不是“该不该提权”,而是提权后npm脚本开始以root身份删库、改系统配置却毫无感知——这些细节比报错本身更值得盯紧。











