断点红点亮但程序不暂停，首要检查二进制是否含调试信息：运行 readelf -S ./binary | grep debug，无输出则需禁用 -ldflags="-s -w" 并添加 -gcflags="all=-N -l" 编译。
断点红点亮着但程序从不暂停？先看构建是否带调试信息
GoLand 断点不生效，最常被跳过的根本原因不是 IDE 问题，而是二进制里压根没嵌入调试符号。Delve 没有 .debug_* 段就无法把源码行号映射到机器指令。
检查方法：运行 readelf -S ./your_binary | grep debug，若无输出，说明调试信息已被剥离。
- 编译时禁用 strip：确保没加
-ldflags="-s -w"—— 这个标志在 CI 脚本或 Makefile 里藏得最深 - 禁用优化和内联：调试阶段必须加
-gcflags="all=-N -l"，否则变量不可见、断点跳行甚至跳函数 - 别用
go run main.go直接调试：它生成临时二进制，路径不稳定，GoLand 无法建立可靠 source map；改用dlv debug或配置 Run Kind 为 “Package” - 确认 GoLand 的 “Build before run” 已勾选，否则改完代码后仍用旧二进制跑
断点打在第三方包或 replace 本地模块里却灰掉？源码路径没对齐
GoLand 不会自动索引 go.mod 以外的任意路径。哪怕 replace github.com/foo/bar => ../bar 写得完全正确，IDE 也不知道该去哪找 ../bar 的源码。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 本地 replace 路径必须是一个合法 Go module：含
go.mod文件，且其module声明与 replace 行严格一致（大小写、斜杠方向都不能错） - 右键点击该本地目录 → Add as Module（不是 “Mark as Sources Root”），否则 IDE 不会为其构建符号索引
- vendor 目录默认不可调试：如需临时调试，右键 vendor 下对应包 → Mark Directory as → Sources Root（注意：重启失效）
- 执行
go mod download或点击编辑器右上角的 “Sync dependencies”，强制刷新 GoLand 的模块缓存
条件断点写了却没触发？作用域和求值时机错了
GoLand 在断点行「执行前」求值条件表达式，且只访问当前 goroutine 当前栈帧里的变量。写错语法或越界访问，断点不会报错，只会静默跳过。
- 表达式必须是单行、纯布尔、无副作用：禁止
fmt.Println()、defer、go、return，也不能调用可能 panic 的方法（如items[0]） - 引用 map/slice 前务必判空：
m != nil && m["key"] == "val"，否则条件自身 panic 导致断点跳过 - 结构体字段访问前确认非 nil：
user != nil && user.Name == "admin"，nil 指针解引用会使条件求值失败 - goroutine 中设条件断点要小心：GoLand 默认只在当前 goroutine 求值，无法跨 goroutine 访问变量
变量显示“不可用”或调试器卡在第一步？Delve 版本与 Go 版本不匹配
Go 1.25+ 对 DWARF 信息格式做了调整，旧版 Delve（如 v1.20.x 及更早）无法解析，直接导致变量不可见、断点不命中、甚至 could not launch process: decoding dwarf section info 报错。
- 升级 Delve 到 v1.21+：
go install github.com/go-delve/delve/cmd/dlv@latest - 确认 GoLand 使用的是新版本 dlv：Help → Edit Custom Properties → 添加
dlv.path=/absolute/path/to/dlv（不能用$GOPATH环境变量） - 重启 GoLand，避免缓存残留；必要时 File → Invalidate Caches and Restart
- 检查
dlv version输出中 Build ID 是否包含 2026 年时间戳（如$Id: ... 2026...），确保不是本地误装的旧版
