先确认变量是否在进程启动时注入，而非代码错误；goland需手动配置run configuration中的environment variables并勾选include system environment variables，否则读不到。
运行时 os.Getenv() 读不到变量？先确认是运行时还是编译时
Go 程序里用 os.Getenv("CONFIG_PATH") 读环境变量，结果返回空字符串——这几乎总是因为变量没在**进程启动时**注入，而不是代码写错了。GoLand 不会自动把系统终端里的 export CONFIG_PATH=xxx 带进运行配置里，必须显式配置。编译时注入（如 -ldflags "-X main.Version=..."）和运行时注入是两套机制，混用会导致“明明 terminal 里能 echo 出来，IDE 里却读不到”的困惑。
在 Run Configuration 里填 Environment variables 才生效
点击右上角运行配置下拉框 → Edit Configurations… → 选中你的 Go Build 配置 → 找到 Environment variables 栏右侧的 … 按钮 → 逐行添加键值对：
CONFIG_PATH=./config.yamlLOG_LEVEL=debug-
PATH=/usr/local/bin:/opt/homebrew/bin:$PATH（别漏掉$PATH，否则exec: "jq": executable file not found）
填完后务必勾选 Include system environment variables，否则 HOME、USER 这类基础变量也会丢失。
Working directory 错了，相对路径直接失效
os.Getenv() 能读到变量，不代表 os.Open(*configPath) 就能打开文件——如果 Working directory 设错，./config.yaml 就会从错误起点解析。常见错误：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 留空 Working directory → GoLand 默认用项目根目录，但你的
config.yaml其实放在./cmd/api/下 - 设成
$ProjectFileDir$→ 项目根目录，同上 - 正确做法：设为
$ProjectFileDir$/cmd/api（绝对路径）或$FileDir$（动态匹配当前main.go所在目录）
验证方法：在 main() 开头加一行 fmt.Println("wd:", os.Getwd())，运行看输出是否符合预期。
测试函数里设环境变量？别用 os.Setenv
写单元测试时想模拟环境变量，直接在 TestXxx 里调 os.Setenv("CONFIG_PATH", "test.yaml") 是危险操作。Go 的 go test -parallel 会让多个测试并发执行，A 测试刚设完，B 测试立刻覆盖，A 后续读到的就是 B 的值。这不是 GoLand 的锅，是 Go 测试模型本身限制。
安全做法只有两种：
- 用
flag+Program arguments：测试函数里解析flag.String("config", "", "")，然后在 Run Configuration 的Program arguments里传-config=test.yaml - 用临时文件或硬编码路径：测试不依赖环境变量，直接加载固定路径的测试配置
真正容易被忽略的是：环境变量的生命周期只存在于单次进程内，且 GoLand 的每个运行配置都是独立进程。改完配置不重启调试会话，旧值可能还在缓存里。最稳妥的验证方式，永远是加一行 fmt.Printf("env: %+v", os.Environ()) 看实际注入了什么。
