go本地调试需闭环：必须用dlv调试、go.mod初始化项目、-race日常检测、wire/fx注入不可手补。否则断点失效、竞态难查、依赖nil。
Go语言环境能跑起来，不代表本地调试环境就 ready 了。很多开发者装完 go 命令、能 go run main.go 出结果，就以为万事大吉，结果一到断点调试、依赖注入生成、API 接口热重载，全卡住——问题不在 Go 本身，而在调试链路没闭环。
go version 和 GOPATH 不再是默认配置项
Go 1.16 起彻底移除了隐式 GOPATH 模式，1.18 后模块（go.mod）成为强制标准。你现在执行 go version 看到的是 go version go1.22.4 darwin/arm64 或类似，但若项目根目录下没有 go.mod，go build 会退化成老式 GOPATH 模式，导致 go list 找不到包、IDE 无法索引、dlv 调试时变量不可见。
- 新建项目必须先运行
go mod init your-module-name，模块名建议用域名前缀（如github.com/yourname/project），避免后续导入冲突 - 不要手动设置
GOPATH；如果已有旧项目，用go mod init+go mod tidy迁移，别试图保留src目录结构 -
GOBIN可以设，但推荐用go install xxx@latest管理二进制工具，比全局 PATH 更可控
VS Code + Delve 是目前最稳的本地调试组合
Go 官方推荐的调试器是 dlv（Delve），不是 GDB，也不是 IDE 自带的“模拟调试”。很多初学者用 VS Code 点绿色三角直接运行，看起来能跑，但根本没走调试通道——断点不命中、goroutine 切换失效、局部变量显示 <optimized></optimized>，全是这个原因。
- 必须单独安装
dlv：go install github.com/go-delve/delve/cmd/dlv@latest - VS Code 中禁用 “Run Debug” 默认配置，改用
.vscode/launch.json显式指定"dlvLoadConfig"和"dlvAttachPort"，尤其注意"mode": "exec"（用于调试已编译二进制）和"mode": "auto"（推荐）的区别 - 调试 Web 服务（如 Gin）时，加
"env": {"GIN_MODE": "debug"}，否则gin.Default()会屏蔽部分 panic 信息，断点跳过关键路径
go test -count=1 -race 要进日常开发流程
Go 的竞态检测器（-race）不是上线前才跑的可选工具，它必须在每次本地提交前执行。因为 goroutine + channel 的组合太容易写出“看起来正确、压测崩掉”的代码，而这类 bug 在单步调试里几乎不可见。
- 写完一个含并发逻辑的函数，立刻执行
go test -count=1 -race -run=TestYourFuncName；-count=1防止缓存掩盖问题 - 测试文件里别漏掉
func TestMain(m *testing.M)中调用os.Exit(m.Run())，否则-race会静默失效 - CI 流水线里必须包含
go test -race ./...，但本地不跑，等于没防住——race detector 开销大，但只影响执行速度，不影响逻辑行为
Wire 或 fx 生成的注入代码不能靠手写补
用 wire 或 fx 做依赖注入，核心价值不是“少写 new”，而是把对象生命周期和依赖图变成可验证的编译期产物。很多人调试时发现某 service 是 nil，第一反应是“我漏写了 NewXXX”，然后手补一个构造函数——这直接绕过了整个注入链，后续所有拦截、装饰、日志埋点全失效。
- 修改 provider 后，必须重新运行
wire generate（或fx gen），生成的wire_gen.go文件要 git commit，不能忽略 - 调试时想临时绕过注入？用
go run -gcflags="-l" main.go关闭内联，方便在生成的NewXXXSet函数里打点，而不是自己 new - Wire 报错常见于 provider 返回类型与 interface 不匹配，比如返回
*sql.DB却想赋给database.Querier接口——检查var _ database.Querier = (*sql.DB)(nil)是否成立
真正卡住人的从来不是 go install 成不成功，而是 dlv 连不上、go test -race 报一堆地址冲突、Wire 生成的代码里某个字段始终 nil 却查不出在哪漏注册——这些都得在编码当下就暴露，而不是等集成测试崩了才翻日志。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
