goland 默认不加载 shell 配置文件中的环境变量，因其 terminal 和 run 配置启动的是 non-login、non-interactive shell；需分别配置 terminal 的 shell path 加 -l 参数和 run configuration 中手动注入环境变量，并优先使用 os.lookupenv 安全读取。
GoLand 默认不读取你 shell 里 export 的环境变量，哪怕你在 ~/.zshrc 里写了 export API_KEY=xxx，IDE 内置终端和运行配置都看不到它——这不是 Go 的问题，是 GoLand 启动进程时没走登录流程。
为什么 os.Getenv("XXX") 在 GoLand 里总是空的
根本原因是：GoLand 的 Terminal 和 Run 配置默认启动的是 non-login、non-interactive shell，它跳过了 ~/.zshrc、~/.bash_profile 或 $PROFILE 的加载。所以即使你在 iTerm 里 echo $API_KEY 能输出，GoLand 里就是空的。
- 验证方式：在 GoLand Terminal 里执行
env | grep API_KEY，为空就确认没继承 - 注意：这和
go env输出无关——go env显示的是 Go 工具链自己的缓存值，不是当前进程环境 - Windows 用户别依赖大小写不敏感：虽然
os.Getenv("path")在 Windows 可能碰巧返回值，但 Linux/macOS 下一定失败，别写这种跨平台不可靠逻辑
让内置 Terminal 读到系统环境变量
必须让它以 login shell 方式启动，才能触发配置文件加载。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- macOS / Linux：打开
Settings → Tools → Terminal，把Shell path改成/bin/zsh -l（或/bin/bash -l），末尾的-l是关键 - Windows：设为
powershell.exe -ExecutionPolicy Bypass -NoExit -Command ". $PROFILE"，确保加载用户配置 - 改完后关闭所有 Terminal 标签页，再新开一个，执行
env | grep YOUR_VAR确认变量已出现 - 如果用的是 zsh + oh-my-zsh，确认
~/.zshrc末尾没有return提前退出（常见于某些主题模板）
让 Run/Debug 配置读到系统环境变量
Terminal 设置只影响终端，不影响你点 ▶️ 运行的程序。Run Configuration 是独立进程，必须显式注入。
- 进
Run → Edit Configurations → Templates → Go Build（或你的具体配置） - 在
Environment variables栏点击…，手动添加YOUR_VAR=value - 不想每个配置都填？可以填在
Templates → Go Build，它会作为所有新建配置的默认值 - 如果变量值含空格或特殊字符（如
DB_URL="postgres://u:p@host/db name"），用双引号包裹整个值，IDE 会自动转义
os.Getenv 不可靠，改用 os.LookupEnv
即使环境变量成功传进来了，os.Getenv 仍会掩盖一个关键问题：它对“未设置”和“设为空字符串”都返回 ""。
- 正确写法：
value, ok := os.LookupEnv("API_TIMEOUT")；只有ok == true才代表变量真实存在 - 值为空也要校验：
if ok && strings.TrimSpace(value) == ""，否则运维误配API_TIMEOUT=""就静默 fallback 了 - 必填变量直接
log.Fatal：if !ok { log.Fatal("missing required env: DATABASE_URL") } - 别在
init()函数里读——包初始化顺序不确定，可能早于环境注入时机
最常被忽略的一点：GOROOT 和 GO111MODULE 这两个变量即使出现在 Terminal 环境里，GoLand 也**不会自动采纳**。它们由 IDE 自己的 SDK 配置和模块开关控制，必须在 Settings → Go 和 Run → Edit Configurations 里单独设置，否则照样报 “Go SDK not found” 或 “not in a module”。
