如何在运行时为Hydra配置文件设置新参数？

报错的核心原因是：Hydra默认返回的OmegaConf配置处于struct模式，这种模式会严格限制只能修改已定义的键，禁止添加配置文件中不存在的新参数，以此避免拼写错误或意外配置。

以下是三种可行的解决方式：

方法1：临时解除struct限制 #

使用OmegaConf.set_struct()临时关闭结构化限制，添加参数后可选择重新开启：

import hydra
from omegaconf import OmegaConf

@hydra.main(config_path="path/to/your/config_directory", config_name="config")
def main(cfg):
    # 关闭struct限制，允许添加新键
    OmegaConf.set_struct(cfg, False)
    cfg.new_parameter = "hello new parameter"
    # 可选：重新开启限制，避免后续误操作
    OmegaConf.set_struct(cfg, True)
    print(cfg.new_parameter)

if __name__ == "__main__":
    main()

方法2：使用OmegaConf.update强制添加 #

直接通过OmegaConf.update()的force_add=True参数强制插入新键，无需修改struct模式：

import hydra
from omegaconf import OmegaConf

@hydra.main(config_path="path/to/your/config_directory", config_name="config")
def main(cfg):
    OmegaConf.update(cfg, "new_parameter", "hello new parameter", force_add=True)
    print(cfg.new_parameter)

if __name__ == "__main__":
    main()

方法3：预先在配置文件中声明可选键 #

如果有权限修改配置文件，可以预先将需要动态赋值的键设为null（或默认值），这样运行时直接赋值不会触发报错：
在你的config.yaml中添加：

new_parameter: null

然后代码中直接赋值即可：

import hydra
from omegaconf import OmegaConf

@hydra.main(config_path="path/to/your/config_directory", config_name="config")
def main(cfg):
    cfg.new_parameter = "hello new parameter"
    print(cfg.new_parameter)

if __name__ == "__main__":
    main()

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