GoLand调试时环境变量不生效，主因是启动方式未继承shell环境或运行配置未显式注入；需从终端启动、检查Debug控制台环境一致性，并在Run Configuration中单独设置DB_HOST等变量，同时确保Working directory等于模块根目录。
调试时环境变量不生效，先确认 GoLand 是否继承了 shell 环境
GoLand 启动方式决定它能否读到你终端里设好的 GOROOT、GOPROXY 或自定义服务变量（如 DB_URL、ENV=prod）。桌面图标双击启动的 GoLand 通常**不会加载 ~/.zshrc 或 ~/.bash_profile**，导致 go env 在 IDE 内置终端里显示空值或旧值。
验证方法：打开 GoLand 底部 Terminal，执行 go env GOPROXY GOROOT；再点开 Debug 控制台（Debug → View Breakpoints → 点右下角小齿轮 → Show Debug Console），执行同样命令——两者输出必须一致且非空。不一致就说明调试器用的是另一套环境。
- macOS：从终端执行
open -a "GoLand.app"或goland .启动，确保继承当前 shell - Windows：用管理员权限打开 PowerShell，cd 到项目目录后执行
goland . - 通用兜底：File → Settings → Go → Environment Variables 里手动填入关键变量（如
GOPROXY=https://goproxy.cn,direct），但注意不要和go env -w冲突
运行/调试配置里漏配 Environment，断点进了但服务起不来
即使环境变量全局生效，GoLand 的调试会话默认**不自动继承系统环境**，尤其对数据库地址、密钥、Feature Flag 开关这类变量。比如你在代码里写了 os.Getenv("REDIS_ADDR")，但没在配置里显式设置，程序会在 nil panic 或连接超时。
正确做法不是改系统级环境变量，而是为每个调试配置单独注入：
- Run → Edit Configurations → 选中你的 Go Build 配置 → 右侧 Environment → 点右侧
…按钮 - 逐行添加键值对：
DB_HOST=localhost、JWT_SECRET=dev-secret、LOG_LEVEL=debug - 若变量值含空格或特殊字符（如
API_BASE_URL=https://api.example.com/v2/），无需引号，GoLand 会自动处理 - 避免在 Environment 里重复设置
GOROOT或GOBIN—— 这些由 SDK 配置管理，手动填反而可能覆盖自动检测结果
调试 HTTP 服务时端口被占用或路由不触发，检查 Working directory 和 Run kind
后端服务（如 Gin、Echo）常依赖相对路径读取配置文件（config.yaml）、静态资源或模板。如果 Working directory 设错，os.Open("config.yaml") 就会报 no such file or directory，但断点仍能进，容易误判为逻辑问题。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
Run kind 选错也会导致入口找不到：
- 选
File：只编译运行单个.go文件，适合 main 包简单脚本；后端服务必须用Directory -
Directory下的Directory字段必须指向含main.go的目录，且该目录下应有go.mod（否则模块解析失败） -
Working directory必须和Directory一致，或设为项目根目录（即go.mod所在位置） - 启动后看 Debug 控制台第一行输出，正常应是
Starting server on :8080；若卡在go: downloading …或报cannot find module，八成是Working directory不在模块根目录
dlv 调试器连不上、gopls 报错，本质是 Go SDK 绑定失效
环境变量只是表象，底层是 GoLand 的 SDK 配置和工具链断裂。典型现象：Debug 按钮灰色、点击后弹窗提示 Cannot find dlv、或控制台刷出 failed to start gopls。
根本原因通常是 SDK 被手动指定为错误路径（比如指向源码目录而非安装目录），或 GOROOT 和 GOBIN 不匹配：
- File → Settings → Go → GOROOT：必须指向 Go 安装根目录（如
/usr/local/go），不能是/usr/local/go/src - 终端执行
which go，路径应为$GOROOT/bin/go；若不一致，说明PATH或GOBIN配置有误 - GoLand 自动检测 SDK 时，会扫描
PATH中第一个go可执行文件，然后推导GOROOT；手动指定 SDK 仅在多版本共存时必要，日常建议关闭手动绑定，让 IDE 自动识别 - 删掉
Settings → Go → Environment Variables里冗余的GOPATH设置——Go 1.16+ 模块模式下它只影响go install输出位置，填了反而干扰依赖解析
调试带环境变量的后端代码，最易被忽略的不是变量本身，而是 Working directory 是否真等于模块根目录、以及 dlv 是否由当前 SDK 的 GOBIN 下二进制启动——这两点错一个，断点进了也拿不到真实配置。
