必须开启模块化且禁用gopath混用，强制go111module=on、根目录含go.mod；禁用replace本地路径，改用go mod edit替换；编译关内联、去符号、锁定架构；热重载用fsnotify+clean build；pprof和逃逸分析需每日集成。
Go 1.22+ 必须开启模块化且禁用 GOPATH 混用
高并发项目一旦依赖混乱，go build 就会随机失败或本地/CI 行为不一致。必须强制启用模块模式：GO111MODULE=on，且项目根目录存在 go.mod。不要在 go.mod 里写 replace example.com/foo => ./foo —— 这会让 CI 构建失败，因为路径不存在。要用 go mod edit -replace=example.com/foo=github.com/foo@v1.2.3，再 go mod tidy 提交变更。
验证方式：go env GO111MODULE 输出必须是 on；go list -m 应列出当前模块名，而非 command-line-arguments。
编译参数要关内联、去符号、锁定架构
高并发服务启动快、内存稳比“编译快”更重要。默认 go build 会内联函数、保留调试符号，导致二进制体积大、首次 GC 延迟高。推荐在 Makefile 中固定使用：
go build -gcflags="all=-l" -ldflags="-s -w" -o bin/app ./cmd/app
-gcflags="all=-l" 关闭所有函数内联，让逃逸分析更真实，也便于 pprof 定位热点；-ldflags="-s -w" 剥离符号表和 DWARF 调试信息，减小体积约 30%；不加 GOOS/GOARCH 时，默认构建当前平台，避免交叉编译引入隐式兼容问题。
注意：禁用内联后，go tool compile -S 看汇编能确认关键 handler 是否仍被内联 —— 如果没被内联，说明结构体指针传递或接口使用过多，得重构。
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
热重载别用 air，用 fsnotify + clean build 组合
air 和 gin run 这类工具会 fork 子进程、绕过 go build 缓存、残留僵尸进程，高并发压测时容易触发 too many open files 或 goroutine 泄漏。真实可用的轻量方案是：
- Linux 下用
inotifywait -e modify,create,delete ./... | while read f; do make build && make restart; done - macOS 下用
fswatch -o ./... | xargs -n1 -I{} make build && make restart -
make build必须包含go clean -cache -modcache，防止 stale cache 导致 panic: "cannot assign to struct field"
HTTP 服务启动前加一行：http.DefaultServeMux.Handle("/debug/pprof/", http.HandlerFunc(pprof.Index))，这样热重载后不用重启就能抓 profile。
pprof 和逃逸分析必须从第一天就集成进开发流
高并发项目不是上线后才查 CPU 占用高，而是每次改完 handler 就该跑一次：go build -gcflags="-m -m" ./cmd/app 2>&1 | grep "moved to heap"。如果看到关键 request 结构体被分配到堆上，就得检查是否传了指针、用了 interface{}、或调了反射。
运行时采集也别等出问题：curl http://localhost:8080/debug/pprof/heap > heap.pprof，然后 go tool pprof heap.pprof 看 top 地址；go tool pprof -http=:8081 cpu.pprof 开 Web 界面看火焰图。这些操作每天花 2 分钟，比线上卡顿后再救火强十倍。
真正容易被忽略的点是：pprof 默认只暴露给 localhost，K8s Pod 里访问不到 —— 要改成 http.ListenAndServe("0.0.0.0:8080", nil)，但仅限 dev 环境；生产环境用 sidecar 或 kubectl port-forward 代理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
