VSCode中npm run xxx失败大概率是PowerShell执行策略拦截或环境变量未加载：执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser后重启终端，或改用Command Prompt/Git Bash；若提示“command not found”，检查PATH是否包含Node.js路径，Windows可切换默认终端，macOS/Linux需启用login shell。
VSCode 里 npm run xxx 失败，不是脚本写错了，大概率是终端没拿到正确的环境或权限。 直接 sudo 或管理员启动只是掩盖问题，还会埋下权限混乱、脚本执行失败、全局模块损坏等隐患。
PowerShell 报 “xxx.ps1 cannot be loaded because running scripts is disabled”
这是 Windows 下 VSCode 默认终端（PowerShell）的执行策略拦截，和文件权限无关。npm 全局安装的命令（如 npm、cnpm、vercel）在 Windows 上会生成 .ps1 脚本，而 PowerShell 默认拒绝运行。
- 在 VSCode 内置终端中运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 执行后关闭并重新打开终端（不用重启 VSCode）
- 验证是否生效：
Get-ExecutionPolicy -Scope CurrentUser应返回RemoteSigned - 别用
-Scope LocalMachine，否则普通用户终端无法覆盖，得开管理员 PowerShell 才能改回来
VSCode 终端里敲 npm 提示 “command not found” 或 “不是内部或外部命令”
本质是 PATH 没加载全——VSCode 启动终端时不会自动读取你的 shell 配置（比如 ~/.zshrc 或 Windows 用户环境变量），导致它根本找不到 npm 可执行文件。
- 先确认系统级 PATH 是否真包含 Node.js 路径：Windows 运行
where npm，macOS/Linux 运行which npm - 在 VSCode 终端里执行
echo %PATH%（Windows）或echo $PATH（macOS/Linux），对比系统终端输出，缺了C:\Program Files\nodejs或/usr/local/bin就坐实是继承问题 - Windows 推荐改默认终端为
Command Prompt或Git Bash（Ctrl+Shift+P →Terminal: Select Default Profile） - macOS/Linux 用户需开启 login shell：设置
terminal.integrated.shellArgs为["-l"]
npm install -g 报 EACCES 或 permission denied
这不是 VSCode 的锅，是 npm 试图往系统目录（如 /usr/local/lib/node_modules 或 C:\Program Files\nodejs\node_modules）写文件，但当前用户无权操作。
- macOS/Linux：运行
npm config set prefix ~/.local，再把~/.local/bin加进$PATH（改~/.zshrc） - Windows：优先用
npm install --user替代-g；若必须装 CLI 工具（如vercel），先查它是否支持本地npx vercel启动 - 绝对不要在 VSCode 终端里敲
sudo npm install -g—— root 权限会污染node_modules权限，后续普通用户操作可能持续失败 - 已误用
sudo的，建议重置权限：sudo chown -R $(whoami) ~/.npm和sudo chown -R $(whoami) /usr/local/lib/node_modules
最易被忽略的一点：改完环境变量或执行策略后，必须关掉所有 VSCode 终端标签页，再新开一个——终端进程不继承父进程重启后的变量，只靠“重启终端”不等于“重载环境”。
