VSCode终端报“command not found”是因为未加载shell配置导致PATH缺失：macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows应手动补PATH或修改用户环境变量，并通过echo $PATH与系统终端对比验证缺失路径。
VSCode终端里所有命令都报“command not found”
这不是你没装对工具，是 VSCode 根本没拿到你的 PATH。系统终端能跑 node、python、idf.py、make，VSCode 里全挂——说明环境链路断了，不是命令本身的问题。
验证只需两步：
在 VSCode 集成终端里运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），再复制同一段命令到系统原生终端（iTerm/Terminal/CMD/PowerShell）里执行，逐行比对。缺了这些路径基本就确诊了：
-
/opt/homebrew/bin（Apple Silicon Homebrew） -
$HOME/.nvm/versions/node/v18.18.2/bin（nvm 管理的 Node） -
%APPDATA% pm（Windows npm 全局模块） -
~/.local/bin（pip install --user安装的命令）
别猜，直接比对输出最可靠。
macOS/Linux 必须设 terminal.integrated.shellArgs 为 ["-l"]
VSCode 默认启动的是非登录 shell，跳过 ~/.zshrc、~/.bash_profile，所以所有 export PATH=... 都不生效。
修复方法很明确：
- 打开 VSCode 设置（
Cmd + ,），搜索terminal.integrated.shellArgs - 设为
["-l"]（注意是小写 L，不是数字 1） - 关闭所有已打开的集成终端面板（不只是关标签页，要彻底关闭终端进程）
- 按
Ctrl + `新建一个终端，再运行echo $PATH验证
如果仍无效，检查 ~/.zshrc 开头是否有类似 [[ -n $ZSH_EVAL_CONTEXT ]] && return 的逻辑——它会让文件提前退出，后面所有 export 都被跳过。临时加一行 echo "zshrc loaded" 就能确认是否真被读取。
Windows 用户别信图形入口，要么重装 PATH，要么手动补
双击图标或从开始菜单启动的 VSCode，拿不到用户环境变量，尤其是 %APPDATA%
pm、C:Program FilesGitin 这类路径。
两个实操解法：
-
长期方案：进「系统属性 → 高级 → 环境变量」，把关键路径加进「用户变量」里的
Path，然后用任务管理器结束所有Code.exe进程，再重启 -
应急方案：VSCode 设置中搜
terminal.integrated.env.windows，填入：{"PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm;C:\Program Files\Git\bin"}
注意反斜杠要双写，路径之间用分号拼接
特别提醒：PATH 在 Windows 注册表中有 2048 字符硬限制，超长会被截断。如果路径列表很长，优先保留你实际用到的几条，删掉历史残留或重复项。
code-runner 或 Python: Run Python File 报 “/bin/sh: python: command not found”
这个错误和集成终端无关，是执行器没走对解释器路径。VSCode 的 Python 扩展选了解释器，只影响调试和 Run Python File，但 code-runner 默认还是调用系统 python 命令。
比如你改了 code-runner.executorMap 里的 "python": "python -u"，它就会去 PATH 里找 python，而不是你选的那个虚拟环境里的可执行文件。
解决办法分两种场景：
- 用
code-runner：把配置改成"python": "python3 -u"或直接写死路径，如"python": "/Users/xxx/.venv/bin/python -u" - 用官方 Python 扩展：确保
python.defaultInterpreterPath指向正确路径，并启用python.terminal.executeInFileDir，这样终端会自动cd到项目根再执行，方便你手动source .venv/bin/activate
复杂点在于：不同扩展、不同执行方式（右键 Run Code / Ctrl+F5 / 终端手动运行）各自维护一套环境逻辑，它们之间不自动同步。你得清楚当前触发的是哪条链路，再针对性修哪一层。
