go build 找不到 main 包而 go run 能运行，是因为 go run 可能隐式启用模块模式或跳过严格校验，而 go build 严格要求当前目录为含合法 go.mod 的模块根目录且存在 package main 声明；需执行 go mod init 初始化模块、确认 main.go 首行为 package main、避免在子目录直接构建。
go build 时找不到 main 包，但 go run 能跑？
这是环境变量和模块初始化不一致导致的典型错觉。你执行 go run main.go 成功，不代表当前目录是合法的 Go 模块根目录；go build 默认要求在模块根下运行，且必须有 main 函数所在的包声明为 package main，同时该目录下要有 go.mod（或位于 GOPATH/src 下，但 Go 1.16+ 已默认关闭 GOPATH 模式）。
常见错误现象：go build 报错 no Go files in current directory 或 cannot find module providing package main。
- 检查是否在项目根目录执行：运行
go mod init example.com/myapp初始化模块（名字可任意，但需符合域名格式） - 确认
main.go文件第一行是package main，且文件名不能是main_test.go或带_linux.go等构建约束后缀 - 避免在子目录里直接
go build—— 它不会向上递归找go.mod，除非显式指定路径：go build ./...
调试时断点不生效，或 dlv 启动报 “could not launch process”
根本原因往往不是 IDE 配置问题，而是编译产物缺失调试信息，或二进制被 strip 过。Go 默认编译会保留 DWARF 调试符号，但以下情况会破坏它：
- 用了
-ldflags="-s -w"：这两个 flag 分别移除符号表和 DWARF 信息，dlv就无法映射源码行号 - 交叉编译未配
CGO_ENABLED=0：若依赖 cgo，在非目标平台调试时可能因动态链接失败而中断 - IDE（如 GoLand）用的是自定义 build tag 或环境变量，但
dlv命令行没同步——比如加了-tags dev编译，调试时却没传相同 tag
验证方式：运行 file ./myapp，输出中应含 with debug_info；若显示 stripped，说明调试信息已被删。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
go test 通过，但 go build + dlv 却 panic 在 init 阶段？
这是因为 go test 默认启用 -race 和更宽松的初始化顺序检测，而普通构建走的是标准初始化流程。很多隐性依赖会在 init() 中触发，比如：
- 数据库驱动注册（
import _ "github.com/lib/pq"）但pgx连接池未配置超时，导致调试时卡在 init 的 DNS 解析 - 全局 logger 实例化时读取不存在的配置文件，
go test可能 mock 掉了 fs，但真实构建会 panic - 第三方库的
init依赖环境变量，而dlv启动时未继承完整 shell 环境（尤其 macOS 上 GUI 启动的 IDE 常丢失$PATH）
建议调试前先用 go build -gcflags="all=-N -l" 关闭内联和优化，再 dlv exec ./myapp，这样更容易定位到哪一行 init 出问题。
修改代码后 dlv 断点跳转到旧代码行？
不是缓存问题，而是二进制没重编译。Go 的调试器不监听文件变化，dlv 加载的是你上次 go build 生成的旧二进制。尤其当你用 IDE 自动构建时，容易忽略底层是否真触发了 rebuild。
- 手动调试务必执行
go build && dlv exec ./myapp，不要复用历史二进制 - VS Code 的
launch.json中若设"mode": "exec"，要确保"program"指向最新构建产物；若用"mode": "auto"，它内部调用go build，但可能跳过某些条件编译文件 - 检查
go list -f '{{.Stale}}' .—— 输出true表示包已过期，需要 rebuild
最隐蔽的坑是：你改了 util/string.go，但主模块没 import 它，go build 根本不重新编译主二进制，dlv 加载的还是老版本。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
