VSCode不自动继承系统环境变量，需手动配置：终端通过terminal.integrated.env.*设置，调试通过launch.json的env字段，构建任务通过tasks.json的options.env，且启动方式影响初始环境继承。

VSCode 本身不接管系统级环境变量，你改了 JAVA_HOME 或 PATH，它不一定“知道”——关键得告诉 VSCode 在哪个场景下用哪些变量。

终端里命令找不到？先看 terminal.integrated.env.*

VSCode 内置终端默认不读 ~/.zshrc 或 PATH，即使你系统里装了 gcc 或 java，终端里仍可能报 command not found。

• Linux/macOS：在 settings.json 中加 "terminal.integrated.env.linux" 或 "terminal.integrated.env.osx"，例如：

  "terminal.integrated.env.osx": {
    "PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"
  }

• Windows：用 "terminal.integrated.env.windows"，路径用分号 ; 拼接，反斜杠要双写或改用正斜杠：

  "C:\Program Files\nodejs;${env:PATH}"

• ⚠️ ${env:PATH} 必须显式写出，否则会覆盖掉原始值；改完要关掉再新建终端才生效

调试时 Java/Python/Go 程序读不到变量？查 launch.json 的 env

调试器启动的进程和终端是隔离的，java.home 配对成功 ≠ 调试时能读到 JAVA_HOME —— 它只影响扩展自身，不透传给被调试进程。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 在项目根目录的 .vscode/launch.json 中，每个 configuration 下加 "env" 字段：

  "env": {
    "JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home",
    "PATH": "${env:PATH}:/opt/homebrew/bin"
  }

• ${env:XXX} 可引用已有变量，但不能执行命令（比如不能写 ${env:HOME}/bin 后面再拼）
• 如果依赖 nvm 切换 Node 版本，必须把完整路径写死，或改用 runtimeExecutable 指向具体可执行文件

运行构建任务（如 javac、make）失败？检查 tasks.json 的 options.env

VSCode 的 Tasks 不继承终端或调试器的环境，尤其当你用 shell 类型任务调外部命令时，PATH 错误会导致 g++: command not found。

• 在 .vscode/tasks.json 的 task 里，用 "options": { "env": { ... } } 注入：

  "options": {
    "env": {
      "PATH": "/usr/local/bin:${env:PATH}",
      "GOPATH": "${workspaceFolder}/go"
    }
  }

• 注意：这里不支持 ${env:HOME}/bin 这种嵌套写法，只能一层 ${env:XXX}
• 若任务依赖当前 shell 的 alias 或函数（比如 ll），别硬塞进 env——Tasks 是纯环境变量，不加载 shell 初始化逻辑

最常被忽略的一点：VSCode 启动方式决定它初始继承的环境。如果你从桌面图标直接启动，它拿不到 ~/.zprofile 里的变量；但从终端执行 code . 打开，就能完整继承当前 shell 环境——这个差异会让同一份配置在不同启动方式下表现不一致。