在Hydra配置中使用环境变量时遇不支持的插值类型错误

问题详情 #

想在Hydra的YAML配置文件里使用环境变量值，按文档配置后运行报错。

我的config.yaml内容：

hydra:
  job:
    env_copy:
      - EXPNAME
# 试过写 hydra:EXPNAME 和直接写 EXPNAME，结果都返回None
test: ${env:EXPNAME}

Ubuntu系统中设置环境变量的命令：

export EXPNAME="123"

运行时触发的错误：

omegaconf.errors.UnsupportedInterpolationType: Unsupported interpolation type env
    full_key: test
    object_type=dict

解决办法 #

1. 确认版本兼容性 #

你参考的是OmegaConf 1.4分支的文档，但如果你的Hydra是1.x版本，对应的OmegaConf通常是2.x，老文档的配置逻辑可能不适用。OmegaConf 2.x中env插值默认是启用的，但需确保Hydra与OmegaConf版本匹配。

2. 手动启用env插值器（针对版本兼容但插值未生效的场景） #

如果env插值未默认开启，可在Hydra配置中显式启用：

hydra:
  job:
    env_copy:
      - EXPNAME
  config_store:
    OmegaConf:
      interpolation:
        enable:
          - env

test: ${env:EXPNAME}

3. 验证环境变量是否正确加载 #

先在终端执行echo $EXPNAME，确认输出为123。如果没有输出，重新执行export EXPNAME="123"或重启终端，确保环境变量在当前会话中生效。

4. 替代方案：使用Hydra runtime配置取环境变量 #

如果上述方法无效，可直接通过Hydra的运行时配置读取环境变量，无需额外启用插值器：

test: ${hydra:runtime.env.EXPNAME}

或者在运行脚本时直接传递参数：

python 你的脚本.py test=${EXPNAME}

内容的提问来源于stack exchange，提问作者KSHMR