VS Code中Java程序运行时传环境变量需在launch.json的env或envFile字段显式配置，因Java插件不自动继承系统变量；env用于硬编码固定值，envFile支持.env格式文件实现多环境切换，且containerEnv在Dev Container中优先级低于launch.json的env。
Java程序运行时怎么传环境变量
VS Code 本身不直接给 Java 程序进程注入环境变量，它靠的是底层 JVM 启动参数或运行时上下文传递。你写的 System.getenv("MY_VAR") 能否取到值，取决于这个变量是否在 JVM 进程启动前就已存在——不是在编辑器里设个 setting 就生效的。
常见错误现象：代码里写 System.getenv("DB_URL")，运行时报 null；或者调试时能取到，终端 java -jar 就取不到，说明环境变量没进对的进程。
- Java 插件默认用
java命令启动语言服务器（JDT.LS），但它和你运行/调试自己程序用的 JVM 是两回事 - VS Code 的集成终端继承的是系统环境变量（或
devcontainer.json注入的），但 Java 程序是否读得到，还得看启动方式 - 如果你用 Maven 或 Gradle 运行，它们会把当前 shell 的环境变量透传给子 JVM；但直接点“Run”按钮（通过
launch.json）则完全走另一套逻辑
launch.json 里配置 env 和 envFile
这是最常用、也最可控的方式：在调试/运行 Java 主类时，显式声明环境变量。VS Code 的 Java 扩展支持 env 和 envFile 字段，它们只作用于当前 launch 配置启动的 JVM 进程。
示例（.vscode/launch.json）：
{
"configurations": [
{
"type": "java",
"name": "Launch App",
"request": "launch",
"mainClass": "com.example.App",
"env": {
"LOG_LEVEL": "DEBUG",
"JAVA_TOOL_OPTIONS": "-Dfile.encoding=UTF-8"
},
"envFile": "${workspaceFolder}/.env.local"
}
]
}
注意点：
-
env是硬编码，适合固定值；envFile支持.env格式（KEY=VALUE），方便不同环境切换 -
envFile路径必须是绝对路径或基于${workspaceFolder}的相对路径，不能用~或环境变量展开 -
JAVA_TOOL_OPTIONS这种 JVM 级别变量，必须通过env传，不能靠-vmargs（Java 扩展不支持该参数）
为什么 JAVA_HOME 不等于程序里的环境变量
JAVA_HOME 是给构建工具（Maven/Gradle）和 VS Code Java 插件用的，不是给你的 Java 应用程序用的。你在代码里调用 System.getenv("JAVA_HOME")，取到的是启动该 JVM 的父进程所带的环境变量——也就是你打开 VS Code 时终端里那个 JAVA_HOME 值。
容易踩的坑：
- Windows 上用快捷方式启动 VS Code，它可能没继承系统环境变量（尤其
JAVA_HOME），导致System.getenv("JAVA_HOME")返回null - macOS/Linux 下用 Dock 或 GUI 启动 VS Code，shell 配置（如
~/.zshrc）里的export可能没加载，envFile或env就成了唯一可靠途径 - 不要在
launch.json里试图覆盖JAVA_HOME来影响 JVM 自身行为——JVM 启动后它就不再读这个变量了
Dev Container 场景下怎么统一环境变量
如果你用 Dev Containers，containerEnv 和 remoteEnv 是关键。但要注意：只有 containerEnv 会真正进入 Java 程序的 System.getenv()；remoteEnv 只影响 VS Code 进程本身及终端，不影响 JVM。
正确写法（.devcontainer/devcontainer.json）：
"containerEnv": {
"APP_ENV": "dev",
"REDIS_HOST": "redis"
},
"remoteEnv": {
"PATH": "${containerEnv:PATH}:/usr/local/bin"
}
重点：
- 所有 Java 程序里
System.getenv("APP_ENV")都能取到"dev" - 如果同时用了
launch.json，它的env会覆盖containerEnv中同名变量（后者优先级更低） - 修改
containerEnv后必须 Rebuild Container，改envFile则只需重启 launch 配置
真正复杂的地方在于层级嵌套：系统环境变量 → VS Code 启动时继承的变量 → Dev Container 注入的变量 → launch.json 显式设置的变量 → JVM 内部 System.setProperty()。每一层都可能覆盖上一层，而 System.getenv() 只能看到最终被传进来的那一批。别指望一个地方配完就全局生效，得按用途分层处理。
