VSCode运行脚本时环境变量不生效,根本原因是终端、调试器、tasks.json、Code Runner等执行上下文各自独立继承环境,不自动加载shell配置(如~/.zshrc),需按场景分别配置:终端启用login shell(-l)、launch.json/tasks.json显式设env字段、Code Runner用export/set前置声明或wrapper脚本。

VSCode 运行脚本时环境变量不生效?先看终端继承逻辑
VSCode 默认不会把系统级或 shell profile 里的环境变量自动注入到集成终端以外的执行上下文(比如 Code Runner、tasks.json 或调试器)。你改了 ~/.zshrc 里的 JAVA_HOME,groovy -v 在终端里能跑,但按 Ctrl+Alt+N 仍报错——这不是 VSCode 配错了,是它根本没加载那套环境。
验证方式:在 VSCode 集成终端里执行 env | grep JAVA_HOME,如果输出为空,说明 shell 初始化没走完;这时即使你在 settings.json 里写了 "terminal.integrated.env.linux",也只影响新开的终端,不影响 Code Runner 启动的独立进程。
- macOS/Linux 用户:确保 VSCode 是从终端启动(
code .),否则它会绕过 shell 的 profile 加载 - Windows 用户:检查是否用的是 PowerShell 而非 CMD,PowerShell 的
$PROFILE加载行为更可靠 - 所有平台:不要依赖 GUI 快捷方式启动 VSCode,它会丢失父 shell 环境
Code Runner 怎么传环境变量?别硬改 executorMap
code-runner.executorMap 是字符串模板,不支持直接插入环境变量。写成 "groovy": "JAVA_HOME=$JAVA_HOME groovy "$fileName"" 在 Linux/macOS 下看似可行,但实际会被 shell 解析两次(VSCode 先解析一次,再交给 shell),极易出错;Windows 更是完全不认 $ 语法。
正确做法是把环境变量声明提前到启动命令之前,用分号或 && 连接:
- Linux/macOS:
"groovy": "export JAVA_HOME='/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home' && groovy -Dfile.encoding=UTF-8 "$fileName"" - Windows:
"groovy": "set JAVA_HOME=C:\Program Files\Java\jdk-17 && groovy -Dfile.encoding=UTF-8 "%fileName%"" - 更稳妥的方式:把这类逻辑抽到一个 wrapper 脚本(如
run-groovy.sh),然后在 executorMap 中调用它
tasks.json 里怎么同步参数和环境?重点看 env 和 args 的包裹时机
VSCode 的 tasks.json 支持 env 字段直接注入环境变量,但它只对 task 启动的进程生效,且**不继承**当前终端已有的变量。所以即使你终端里 JAVA_HOME 正确,task 里仍要显式写一遍。
常见错误是把路径参数直接拼进 args 数组,导致空格或中文路径被截断。例如:
{
"label": "run groovy",
"type": "shell",
"command": "groovy",
"args": ["-Dfile.encoding=UTF-8", "${file}"],
"env": {
"JAVA_HOME": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
}
}
这个配置没问题;但如果 ${file} 是 /Users/me/My Project/test.groovy,而你没加引号,groovy 就会收到两个参数:/Users/me/My 和 Project/test.groovy,直接失败。
- 永远用
"${fileBasenameNoExtension}"替代裸${file}处理带空格路径 -
args里每个值都是独立字符串,不需要手动加引号——VSCode 会自动转义 - 如果要用变量插值(如
${env:JAVA_HOME}),必须确保该变量已在 VSCode 的 session 级别定义(通过settings.json的terminal.integrated.env.*)
共享脚本环境时最易忽略的点:编码与 Shell 类型不一致
同一份 .groovy 脚本,在 macOS 上用 zsh 跑正常,发给 Windows 同事用 Code Runner 运行就乱码或报 illegal character——大概率不是环境变量问题,而是文件编码 + shell 解释器组合踩坑。
VSCode 默认保存为 UTF-8,但 Windows 的 cmd.exe 默认用 GBK,PowerShell 才默认 UTF-8。如果你在 executorMap 里写的是 cmd /c groovy ...,又没加 -Dfile.encoding=UTF-8,就会触发双编码错位。
- 统一强制指定编码:所有 groovy 命令都加
-Dfile.encoding=UTF-8 - 避免混用 shell:Windows 上优先用 PowerShell 启动器,而不是 cmd
- 团队共享时,在工作区根目录放一个
.vscode/settings.json,固定"files.encoding": "utf8"和"terminal.integrated.defaultProfile.windows": "PowerShell"











