dlv debug 启动找不到 main 包是因缺失 main.go 或 go.mod 模块名与路径不匹配；vs code 调试常停在 runtime/标准库，需配置 substitute-path 或 skipinitialize；远程调试须指定 --api-version=2 和 --accept-multiclient；条件断点需用合法 go 表达式且变量必须在作用域内。
dlv debug 启动时找不到 main 包
常见现象是执行 dlv debug 报错：could not launch process: could not find executable for 'main'。根本原因是当前目录下没有可识别的 main.go，或 go.mod 路径与实际模块名不一致。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认当前路径下存在
main.go，且文件内有func main()；若项目是子模块（如cmd/myapp），需切换到该目录再运行dlv debug - 检查
go.mod中的 module 名是否和当前路径匹配，DLV 依赖 Go 的构建逻辑，module 名错误会导致构建失败 - 避免在
vendor/目录或 GOPATH 模式旧项目中直接用dlv debug，优先用dlv exec ./mybinary配合已编译二进制
在 VS Code 中跳过 runtime 和标准库断点
默认调试时频繁停在 runtime.gopark、sync.(*Mutex).Lock 等内部调用，干扰主逻辑排查。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在
.vscode/launch.json的配置里加上"dlvLoadConfig": { "followPointers": true, "maxVariableRecurse": 1, "maxArrayValues": 64, "maxStructFields": -1 }，但真正起作用的是"dlvLoadConfig"下的"skipInitialize": true（仅 dlv v1.21+） - 更通用的做法：在调试会话启动后，手动执行命令
config substitute-path /usr/local/go/src <empty></empty>（DLV CLI）或在 VS Code 的调试控制台输入dlv config substitute-path /usr/local/go/src ""，让源码映射失效，从而跳过标准库断点 - VS Code 插件设置里关闭
dlv: Show Global Variables，减少变量加载压力，间接降低卡顿感
远程调试时 dlv --headless 无法连接
典型错误是客户端连上 dlv --headless --listen :2345 后立即断开，或提示 connection refused / EOF。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须加
--api-version=2，新版 VS Code 和 JetBrains 插件默认只支持 API v2；漏掉这个参数，服务端会静默拒绝兼容请求 - 确保
--accept-multiclient开启，否则第二个调试器连接会被踢出；但注意它不支持并发 attach，只是允许重连 - 防火墙和容器网络常被忽略：Docker 运行时要加
-p 2345:2345，且宿主机 iptables 不能拦截该端口；K8s 中则需在 Pod spec 里显式暴露端口并设 readinessProbe 延迟
条件断点写法导致 dlv crash 或不生效
比如写 break main.go:42 if user.ID == 0，结果断点从不触发，甚至 dlv 进程 panic 退出。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 条件表达式必须是 Go 表达式语法，且所有变量必须在当前作用域可见；
user若是局部变量，在函数退出后条件失效，但断点仍存在——这容易误判为“不生效” - 避免在条件中调用函数（如
if len(s) > 0可以，但if strings.Contains(s, "x")不行），DLV 的表达式求值器不支持函数调用 - 字符串比较要用双引号，
if name == "admin"正确，if name == 'admin'（单引号）会解析失败；布尔字面量必须小写：true/false，大写会报错
最麻烦的其实是 goroutine 切换上下文时的变量可见性——同一行代码，在不同 goroutine 中看到的局部变量可能根本不同，而 DLV 默认只显示当前 goroutine 的栈帧。这点不手动 goroutines + goroutine N frames 切换，很容易以为“变量没变”，其实是看错了协程。
