VSCode终端报“command not found”主因是未加载shell配置导致PATH缺失，需检查terminal.integrated.profiles是否含-l参数、验证$PATH、修复shell初始化或手动补PATH。
终端显示“command not found”但命令在系统里存在
这是最常见的假性异常：vscode 终端没加载 shell 的初始化配置（比如 ~/.zshrc 或 ~/.bash_profile），导致 path 未正确设置，哪怕你在 iterm 或 terminal 里能直接运行 node、python3，vscode 里却报错。
验证方法：在 VSCode 终端里执行 echo $PATH，对比系统终端输出，通常会发现缺失关键路径（如 /opt/homebrew/bin、~/.local/bin 或 Node.js 的 nvm 路径）。
- macOS / Linux：检查 VSCode 是否以非登录 shell 启动 —— 默认情况下它调用的是
zsh -i -l（带-l表示登录 shell），但如果终端配置被覆盖，可能失效；可手动在 VSCode 设置中搜索terminal.integrated.profiles，确认对应 shell 的args包含-l - Windows：PowerShell 终端若提示
The term 'xxx' is not recognized，大概率是$env:PATH没加载用户环境变量，需检查$PROFILE是否被跳过，或改用 Windows Terminal 作为默认终端（在设置中设terminal.integrated.defaultProfile.windows为"Windows PowerShell"并确保其启动参数含-ExecutionPolicy Bypass） - 通用修复：临时补 PATH，比如
export PATH="$HOME/.nvm/versions/node/v18.18.2/bin:$PATH"；长期方案是确保 VSCode 终端启动时读取你的 shell 配置文件（例如在~/.zshrc开头加[[ -n $ZSH_EVAL_CONTEXT ]] && return防止重复加载，再确认 VSCode 终端 profile 正确引用该文件）
Python 命令指向错误版本或虚拟环境未激活
VSCode 终端常出现 python --version 显示系统自带的 2.7 或 3.9，而你项目明明用的是 3.11 + venv；或者 pip install 装完包后 import 报错 —— 根本原因是终端没继承 VSCode 当前工作区选中的 Python 解释器环境。
VSCode 的 Python 扩展管理的是调试/运行时解释器，**不自动同步到集成终端**。终端始终使用 shell 自身的 python 查找逻辑。
- 不要依赖“Python: Select Interpreter”来影响终端行为；要手动激活：进入项目目录后，运行
source .venv/bin/activate（Linux/macOS）或.venv\Scripts\Activate.ps1（Windows PowerShell） - 若提示
Activate.ps1 cannot be loaded，说明执行策略限制，临时允许：执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 想自动激活？可在 VSCode 设置中启用
python.terminal.executeInFileDir（确保 cd 到项目根），再配合 shell 的cdhook（如 zsh 的chpwd()函数）检测.venv并自动 source，但注意这会影响所有终端，非 VSCode 独占
中文路径或空格导致命令执行失败（尤其 Windows）
当你在路径含中文或空格的文件夹中打开 VSCode（比如 C:\Users\张三\Documents\my project），终端执行 npm run dev 或 python script.py 可能直接报错，提示找不到文件、拒绝访问，或把路径截断成 C:\Users\张三\Documents\my。
根本原因：部分 CLI 工具（尤其是旧版 npm、某些 Python 脚本）未对参数做引号包裹，shell 解析时把空格当作分隔符。
- 临时规避：用英文路径重开 VSCode，比如
code C:/dev/my_project - 强制转义：在终端中手动加引号，如
python "script with space.py"或npm run "build:prod" - Windows 特别注意：
cmd.exe对 Unicode 支持差，建议把默认终端切换为PowerShell或Git Bash；并在 VSCode 设置中开启terminal.integrated.env.windows，添加"PYTHONIOENCODING": "utf-8"
终端输出乱码或无法输入中文（尤其 Windows + PowerShell）
执行命令后输出一堆 ，或粘贴中文直接变空格/报错 —— 这不是 VSCode bug，而是终端编码与当前 locale 不匹配，常见于 Windows 上 PowerShell 默认用 GBK，但项目/脚本按 UTF-8 编码生成输出。
PowerShell 7+ 默认 UTF-8，但 VSCode 内置终端可能仍调用旧版 PowerShell（5.1），其 $OutputEncoding 和控制台代码页不一致。
- 查当前编码：PowerShell 中运行
[Console]::OutputEncoding和$OutputEncoding，若显示System.Text.ASCIIEncoding或GBK，就需修正 - 临时修复：运行
[Console]::OutputEncoding = [Text.UTF8Encoding]::new()和$OutputEncoding = [Text.UTF8Encoding]::new() - 永久生效：把上面两行加到
$PROFILE（路径可通过$PROFILE命令查看），并确保该文件已存在（不存在则New-Item -Path $PROFILE -Force创建） - VSCode 层面：设置
terminal.integrated.defaultProfile.windows为"PowerShell"（而非"Command Prompt"），并禁用terminal.integrated.experimentalUseCoreHost（某些版本 Core Host 会干扰编码）
真正棘手的从来不是“命令没装”，而是终端环境和编辑器上下文之间那层看不见的隔离——PATH、shell 初始化、编码、权限策略，每个都可能单独生效又互相干扰。修一个参数容易，但得清楚它在哪一层起作用、是否被上层覆盖。多看 which xxx、Get-Command xxx、echo $SHELL，比盲目重装插件有用得多。
