goland调试按钮灰色是因为未正确安装或识别dlv：需用go install安装、在settings→go→debugger中指定路径并重启ide；goroot须指向含src/pkg/bin的完整根目录；断点不命中需检查build kind为package、启用go modules及goproxy配置。
dlv 没装好或没认到，调试按钮就只是个灰色图标——这不是项目问题，是 GoLand 根本没找到调试器。
GoLand 找不到 dlv？先确认安装和路径
GoLand 不会自动帮你装 dlv，也不会从系统 PATH 里继承它。即使终端里 dlv version 能跑，IDE 也可能完全无视。
- 在终端执行
go install github.com/go-delve/delve/cmd/dlv@latest（注意是go install，不是go get） - 运行
dlv version验证是否成功；若报command not found，检查$GOBIN或$GOPATH/bin是否在系统PATH中 - GoLand 设置里进入 Settings → Go → Debugger → Delve，选
Use built-in delve（推荐），或手动指定dlv可执行文件路径（比如$GOPATH/bin/dlv） - 改完必须重启 GoLand，仅 Reload project 无效
GOROOT 设错：Go SDK “半瘫痪” 的根源
GOROOT 必须指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），不能是 bin 子目录，也不能带尾斜杠。设错后 go version 可能输出为空，go env GOROOT 返回错误路径，GoLand 直接报 “No Go SDK found”。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在 Settings → Go → GOROOT 中点击
+，手动选择含src、pkg、bin的完整根目录 - Windows 用户避免填成
C:\Go\bin；macOS/Linux 用户别用软链接未解析的路径（如~/go-1.26要确保真实存在） - 该路径下必须有
src/runtime/internal/sys/zversion.go，且含TheVersion常量；缺失需手动补上（如const TheVersion = `go1.26.0`）
断点不命中？检查运行配置类型和模块模式
断点红点显示但程序不暂停，大概率是启动方式和代码结构不匹配，而非网络或权限问题。
- 运行配置中 Build kind 必须选
Package（不是File），Package path 填./或具体包名（如main） - 确认项目根目录有
go.mod，且 Settings → Go → Go Modules 中勾选了Enable Go modules integration - GOPROXY 必须显式填写（如
https://goproxy.cn,direct），不能依赖系统环境变量——GoLand 默认不继承它们 - 编译时禁用优化：
go build -gcflags="all=-N -l"是调试前提；若用 Run Configuration 启动，确保没开启-ldflags="-s -w"类参数
容器内调试卡在 “Connecting”？端口和监听地址必须对齐
宿主机 GoLand 连不上容器里的 dlv，根本原因是网络隔离 + 绑定地址错误。localhost 在容器里 ≠ 宿主机 localhost。
- 容器启动命令必须用
dlv exec --headless --addr=0.0.0.0:2345 --api-version=2 ./myapp（注意是0.0.0.0，不是127.0.0.1） -
docker run必须加-p 2345:2345；Dockerfile 中加EXPOSE 2345 - GoLand 的 Remote Debug 配置中，Host 填
localhost，Port 填2345，不勾选Use module SDK - 多阶段构建镜像调试失败？不是 IDE 问题，是镜像里没源码——用 Source Map 映射本地路径，别往生产镜像塞代码
,direct、监听地址写成 127.0.0.1——这些细节不验证，只靠“应该可以”，就会反复卡在同一个地方。
