VSCode终端报“command not found”或“.ps1 cannot be loaded”主因是未继承系统PATH或PowerShell执行策略受限;修复需两步:先比对echo $PATH与系统终端输出确认PATH缺失,再依平台启用login shell(macOS/Linux设terminal.integrated.shellArgs为["-l"])、手动补全PATH(Windows)或运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser(PowerShell)。

VSCode内置终端执行命令报“command not found”或“xxx.ps1 cannot be loaded”,不是你没装工具,而是VSCode根本没拿到系统PATH或PowerShell策略拦住了脚本——修复只需两步:确认环境变量是否继承、解除执行限制。
为什么 echo $PATH / echo %PATH% 在VSCode终端里缺路径
VSCode图形界面启动(开始菜单/桌面图标)不读取你改过的系统PATH,尤其是Windows用户级Path(如%APPDATA%
pm)、macOS的~/.zshrc导出的$PATH。它启动的是干净进程,PATH只含最小集。
- 验证方法:在VSCode终端运行
echo $PATH(macOS/Linux)或echo %PATH%(Windows CMD),再在系统终端(iTerm/Terminal/CMD)里跑同一句,逐行比对 - Windows必须通过「系统属性 → 高级 → 环境变量」把
%APPDATA% pm和C:Program FilesGitin等加进用户PATH,改完要彻底退出VSCode(任务管理器杀掉所有Code.exe),再重开 - macOS/Linux用户若用
code命令从终端启动,则~/.zshrc或~/.bash_profile里的export PATH=...才生效;否则图形入口永远跳过这些文件 - 别在
settings.json里硬写"python.defaultInterpreterPath"来绕过——这只是骗过Python插件,npm run、lua等命令照样崩
PowerShell报“The term 'xxx' is not recognized”或“.ps1 cannot be loaded”
这是PowerShell默认执行策略Restricted在作祟,不是权限问题,也不是文件损坏。VSCode默认终端是PowerShell,它连本地.ps1都不放行。
- 在VSCode终端里直接运行:
Get-ExecutionPolicy -Scope CurrentUser,如果返回Restricted就确诊了 - 执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser(无需管理员权限) - 关掉所有集成终端(不只是关标签页,要确保进程退出),再按
Ctrl + `新建一个,重新验证 - 如果误用了
-Scope LocalMachine,普通终端无法覆盖,得开管理员PowerShell执行同命令改回来
npm install -g 报 EACCES 或 permission denied 怎么办
这不是VSCode的问题,是npm试图往系统目录(如/usr/local/lib/node_modules或C:Program Files
odejs
ode_modules)写文件,但当前用户没权限。硬开管理员终端是下策,容易污染全局环境。
- macOS/Linux:运行
npm config set prefix ~/.local,再把~/.local/bin加进$PATH(改~/.zshrc),之后所有npm install -g都落到用户目录 - Windows:优先用
npm install --user替代全局安装;若必须装CLI(如vercel),先查它是否支持本地调用(比如npx vercel) - 绝对不要在VSCode终端里敲
sudo npm install -g——npm会以root身份执行脚本,可能破坏node_modules所有权,后续普通用户操作全失败 - 检查npm全局路径:
npm config get prefix,确保其bin子目录已加入PATH,例如export PATH="$(npm config get prefix)/bin:$PATH"
Code Runner点▶️没反应、F5调试报“Cannot find program”
VSCode不“运行”代码,它只是调度器:▶️走Code Runner插件,F5走launch.json和调试扩展,终端命令则完全依赖PATH——三者互不感知,配错一个就断链。
- ▶️按钮消失?先确认文件后缀正确(如
.py)、工作区已信任(左下角无Restricted Mode)、且code-runner扩展已启用;再检查code-runner.executorMap里对应语言的值是不是空字符串或拼错成pyhton - F5失败?先看是否弹出环境选择框(没弹=缺调试扩展);再打开
.vscode/launch.json,把"program": "C:/full/path.py"改成"program": "${file}",避免路径硬编码失效 - Node.js用户注意:
runtimeExecutable字段不能只填"node",得写绝对路径如"C:\Program Files\nodejs\node.exe",因为调试器不继承终端PATH - Python用户:按
Ctrl+Shift+P→Python: Select Interpreter,选中你实际pip install的环境(conda虚拟环境要选envs/xxx/bin/python,不是base环境)
最常被忽略的一点:PATH修改后,必须彻底杀掉VSCode所有进程再重开——仅关闭窗口或重启终端,旧进程仍持着旧环境变量,怎么改都无效。


















