Delve 报“no main package”是因为当前目录无 main.go 或其包名非 package main；需确保模块根目录下有正确 main.go，多模块时用 dlv exec 或先 build；VS Code 调试必配 mode、program、env（含 GO111MODULE 和 GODEBUG）；Docker 中需避免 dlv 为 PID 1 并添加 SYS_PTRACE 权限；断点不触发常因内联优化，应加 -gcflags="all=-l" 或使用具名函数。
用 Delve 启动调试会话时为什么 dlv debug 报 “no main package”？
Go 程序必须有 main 函数且位于 main 包中，Delve 才能启动调试。常见原因是当前目录下没有 main.go，或文件在非 main 包里（比如写了 package utils）。
- 确保当前工作目录是模块根目录（含
go.mod），且至少有一个main.go文件 -
main.go顶部必须是package main，不能是package main_test或其他名称 - 如果项目是多模块结构，
dlv debug默认只构建当前目录的包；跨目录调试需用dlv exec ./path/to/binary或先go build - 使用
dlv debug --headless --listen=:2345 --api-version=2启动后，VS Code 的launch.json才能连上 —— 这个端口和 API 版本不匹配是远程调试失败最常见原因
VS Code 中 launch.json 配置哪些字段不能省略？
VS Code 的 Go 调试依赖 launch.json 明确指定执行入口和调试器行为，漏掉关键字段会导致“无法启动”或“断点不命中”。
-
"mode": "auto"或"mode": "exec"必须显式设置；"auto"适用于源码调试，"exec"用于已编译二进制 -
"program"必须指向可运行的 Go 源码路径（如"./cmd/myapp/main.go"），不能是目录或go.mod -
"env"下建议加"GODEBUG": "asyncpreemptoff=1"，避免 goroutine 切换干扰断点停靠（尤其在循环或 channel 操作中） - 若用 Go Modules，
"env": {"GO111MODULE": "on"}推荐显式声明，防止旧版 VS Code 插件读取错误 GOPATH 环境
在 Docker 容器里调试 Go 服务，dlv 进程为什么总被 SIGTERM 杀掉？
Docker 默认发送 SIGTERM 给 PID 1 进程，而 Delve 在容器中常以 PID 1 启动（比如 dlv --headless --listen=:40000 ...），导致调试器直接退出。
- 必须让 Delve 不作为 PID 1：改用
ENTRYPOINT ["sh", "-c", "dlv --headless --listen=:40000 --api-version=2 exec ./myapp"]，用 shell 包一层 - 容器启动时加
--cap-add=SYS_PTRACE，否则 Delve 无法注入和挂起目标进程（Linux 内核强制限制） - 镜像里要预装
dlv，或用多阶段构建把dlv二进制 COPY 进最终镜像；别指望go install github.com/go-delve/delve/cmd/dlv@latest在 alpine 上直接跑通 - VS Code 的
remoteAttach配置里"port"必须和容器--publish暴露的端口一致，且宿主机防火墙/SELinux 不拦截
断点打在 http.HandlerFunc 里却从不触发，是 Delve 的 bug 吗？
不是 bug，是 Go 编译器内联优化导致函数体被折叠，Delve 找不到原始行号映射。尤其在 net/http 标准库或简单闭包 handler 中高频出现。
立即学习“go语言免费学习笔记（深入）”；
- 临时关闭内联：编译时加
-gcflags="all=-l"，例如go build -gcflags="all=-l" -o myapp . - 避免写单行 handler：
http.HandleFunc("/ping", func(w http.ResponseWriter, r *http.Request) { ... })→ 改为具名函数，Delve 更容易识别符号 - 如果 handler 是方法调用（如
r.HandleFunc("/api", s.handleUser)），确保s.handleUser方法未被编译器导出或内联（可加//go:noinline注释） - Delve 的
break命令支持函数名断点：break main.(*Server).handleUser比行号更可靠
dlv 版本、宿主机的 VS Code 插件版本、Go SDK 版本三者 API 不对齐，比代码逻辑错误更难排查。 
