如何设置Hydra框架的HYDRA_FULL_ERROR环境变量参数

1. 单次临时运行生效（调试首选） #

该配置仅对当前单次运行生效，不会污染全局环境，根据使用的终端环境选择对应命令：

• Linux/macOS 终端（bash/zsh等）：运行Python脚本前直接添加变量赋值
  HYDRA_FULL_ERROR=1 python 你的脚本名.py
• Windows 命令提示符（CMD）：先设置临时环境变量，再运行脚本
  set HYDRA_FULL_ERROR=1 && python 你的脚本名.py
• Windows PowerShell：
  $env:HYDRA_FULL_ERROR=1; python 你的脚本名.py

2. 在Python代码内直接配置 #

如果不想每次修改运行命令，可在代码中提前设置。注意：该设置必须在导入Hydra相关模块之前完成，否则配置不会生效：

import os
# 提前设置环境变量，位置必须在导入hydra之前
os.environ["HYDRA_FULL_ERROR"] = "1"

# 正常导入Hydra和其他项目依赖
import hydra
import torch
# 后续业务代码...

3. IDE内运行配置（以PyCharm、VS Code为例） #

做PyTorch项目通常会使用IDE调试，可在IDE的运行配置中对当前项目长期生效：

• PyCharm：打开顶部菜单Run -> Edit Configurations，选中对应运行脚本的配置项，在「Environment variables」栏添加键值对HYDRA_FULL_ERROR=1，保存后运行即可。
• VS Code：打开调试配置文件launch.json，在对应调试配置的env字段中添加"HYDRA_FULL_ERROR": "1"，保存后运行调试即可。

4. 全局永久生效（适合长期调试Hydra场景） #

如果需要长期启用该配置，可在系统层面设置环境变量，所有终端、IDE运行时都会自动生效：

• Linux/macOS：将export HYDRA_FULL_ERROR=1写入shell配置文件（bash对应~/.bashrc，zsh对应~/.zshrc），执行source 对应的配置文件路径后生效。
• Windows：打开「系统属性 -> 高级系统设置 -> 环境变量」，在用户变量栏新建变量，变量名填HYDRA_FULL_ERROR，变量值填1，重启终端或IDE后生效。

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