根本原因是VSCode未加载shell配置文件；macOS/Linux需启用login shell（设terminal.integrated.shellArgs为["-l"]），Windows应避免管理员模式运行并确保PATH包含对应路径。
VSCode终端里找不到npm、git、docker或自定义命令，根本不是PATH没配，而是它压根没加载你shell里的配置。 macOS/Linux下双击图标启动的VSCode不读~/.zshrc，Windows用开始菜单启动也不继承“系统环境变量”——这是启动方式决定的，不是设置漏了。
为什么echo $PATH在VSCode终端里缺了一大截
VSCode集成终端默认以非登录、非交互式方式启动Shell（比如zsh -i -l才加载~/.zshrc），所以跳过所有初始化文件。你在~/.zshrc里写的export PATH="/opt/homebrew/bin:$PATH"，对新打开的VSCode终端完全无效。
- 验证方法：在VSCode终端运行
sh -ic "echo $PATH"，再和系统终端里echo $PATH对比，路径长度和顺序明显不同就坐实了 - 别信“改完
~/.zshrc重启VSCode就行”——必须彻底退出（macOS右键Dock选「退出」，Windows任务栏右键选「退出」），否则后台进程（如Code Helper (Renderer)）还在用旧环境 -
terminal.integrated.inheritEnv: true能绕过这个问题，但它只在Windows/macOS上可靠，Linux某些桌面环境（如GNOME）仍可能失败
terminal.integrated.env.*怎么写才不覆盖原始PATH
这个配置是显式注入，但PATH字段会覆盖而非追加——除非你手动拼接原始值。很多人写成"PATH": "/opt/homebrew/bin"，结果系统路径全丢了，连ls都报错。
- 必须用
${env:PATH}引用原始值："PATH": "${env:PATH}:/opt/homebrew/bin" - 平台键要写对：
terminal.integrated.env.osx（macOS）、.linux（Linux）、.windows（Windows），VSCode按当前OS自动合并，写错平台键等于没配 - Windows注意分隔符是
;，不是:；${env:PATH}自带原始分隔符，拼接时直接用;即可，比如"PATH": "${env:PATH};C:\msys64\ucrt64\bin" - 改完设置后，必须关闭所有已打开的集成终端标签页，再新建一个才生效
调试器（F5）和任务（tasks.json）为什么总忽略终端环境
调试器和构建任务启动的是全新进程，和终端环境完全隔离。你在终端里export NODE_ENV=development，对F5启动的Node.js程序毫无影响；终端里能跑gcc，tasks.json里照样报command not found。
-
launch.json里每个configuration都要单独写env字段，不能写在外层；旧字段environment已弃用，写了也无效 -
tasks.json必须在options.env里补全PATH，例如："options": { "env": { "PATH": "${env:PATH}:/usr/local/bin" } } - 别依赖
command: "gcc"——任务系统不解析别名、不展开~、也不查PATH；稳妥做法是用which gcc拿到绝对路径，硬编码进command字段 - Windows上
cl.exe必须配合vcvarsall.bat，不能只加PATH；得用shell类型任务，把调用包成一行："command": "cmd /c "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" x64 && cl.exe ${file}"
远程开发（SSH/Container）时环境变量更难搞
远程场景下，本地VSCode和远程Shell环境是两套体系。你在本地~/.zshrc里配的PATH，对容器里运行的Python调试器没用；远程服务器上export PYTHONPATH=...，本地launch.json里不显式传过去，照样导入失败。
- 先SSH登录远程主机，执行
env | grep YOUR_VAR确认基础环境已设好 - 远程变量要进
launch.json的env字段，或通过settings.json的remoteEnv全局注入（优先级低于launch.json） - Remote-SSH连接后，如果发现PATH还是不对，别急着改配置——先在远程终端里
source ~/.zshrc，然后从那个终端执行code .重新打开VSCode窗口 -
remoteEnv只对整个远程窗口生效，修改后需重启远程窗口（Remote-SSH: Reopen in Container），不是重载窗口
最常被忽略的一点：VSCode有两级环境缓存，一是启动时继承的GUI会话环境，二是终端子进程的继承逻辑。你以为改完系统PATH、点了「Reload Window」就完了，其实后台服务还在用旧PATH。真要彻底刷新，就得杀掉所有VSCode相关进程，再从正确环境里启动。
