GoLand运行配置中环境变量需在Edit Configurations→选中配置→Environment variables字段手动填写，格式为KEY1=value1;KEY2=value2（Windows）或KEY1=value1:KEY2=value2（macOS/Linux），不能依赖shell配置或export命令。
GoLand 运行配置里没看到环境变量？先确认是否填在正确位置
GoLand 的环境变量不是写在代码里或终端配置中就自动生效的，它只读取当前 Run Configuration 中显式声明的键值对。即使你在 ~/.zshrc 里 export 了 API_KEY=abc，不手动加进配置，os.Getenv("API_KEY") 就返回空字符串。
检查步骤：
- 点击右上角运行配置下拉框 → Edit Configurations
- 左侧选中你的 Go 程序配置（如
main.go） - 右侧找到 Environment variables 字段（不是
Program arguments或Working directory） - 输入格式为：
KEY1=value1;KEY2=value2（Windows）或KEY1=value1:KEY2=value2（macOS/Linux），注意分号/冒号是分隔符，不是等号的一部分
常见错误：把变量写成 export KEY=value 或 KEY = value（带空格），GoLand 会直接忽略整条。
为什么终端能 echo 出来，GoLand 却读不到？
因为 Goland 默认启动时用的是“干净”的 shell 环境，不加载你的 ~/.zshrc、~/.bash_profile 或 /etc/environment。它不继承你日常终端里的环境快照。
验证方法：
- 在 Goland 内置 Terminal 里执行
echo $YOUR_VAR—— 如果为空，说明它根本没加载你的 shell 配置 - 打开 Settings → Tools → Terminal，把 Shell path 改成系统真实 shell 路径，比如
/bin/zsh或C:\Windows\System32\cmd.exe - 重启 Goland，再试一次内置 Terminal 的
echo
注意：改完 shell 路径后，Goland 启动的新 Terminal 才会读取你的配置文件；但已有 Terminal 标签页不会自动 reload，得关掉重开。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
os.Getenv 返回空，到底是没设还是设了空字符串？
os.Getenv 对“变量未设置”和“变量值为空”都返回 ""，无法区分。这是最隐蔽的逻辑漏洞之一。
正确做法是用 os.LookupEnv：
port, exists := os.LookupEnv("PORT")
if !exists {
port = "8080"
}
// 或更严格地，拒绝空值
if !exists || port == "" {
log.Fatal("missing or empty required env: PORT")
}
关键点：
-
os.LookupEnv第二个返回值ok bool才表示变量“存在”（哪怕值是""） - 别在业务里反复调用
os.Getenv—— 启动时集中读取、校验、存进 config struct 更安全也更高效 - 敏感变量（如
DATABASE_URL）建议直接log.Fatal，避免静默 fallback 到测试值
Docker + GoLand 调试时环境变量怎么透传？
本地调试容器化服务时，容易漏掉两层透传：
- 第一层：Docker run 命令或
docker-compose.yml中必须显式用-e KEY=VALUE或environment:块传入，ENV指令只影响镜像构建阶段 - 第二层：GoLand 的 Remote Debug 配置里，
Environment variables字段也要同步填——它控制的是 Goland 本地调试器进程本身的环境，不是容器内 Go 进程的
简单验证法：在 main 函数开头加一行 fmt.Printf("env PORT=%q\n", os.Getenv("PORT"))，看输出是 "" 还是实际值。如果连这都打不出来，问题一定出在透传链路上，而不是 Go 代码本身。
复杂点在于，不同部署场景（IDE 直接运行 / Terminal 运行 / Docker / Kubernetes）要求的环境变量注入方式完全不同，且互不兼容。最容易被忽略的是：**你改了系统级环境变量，却忘了重启 Goland** —— 它的进程只继承启动那一刻的环境快照。
