pprof不是导入即用的自动工具，必须满足服务暴露/debug/pprof端点、采样时程序真实运行、分析命令匹配profile类型三前提；下划线导入仅对DefaultServeMux生效，自定义mux需手动挂载且路径末尾斜杠不可省。
pprof 不是“导入就能看到火焰图”的自动工具，它必须满足三个前提：服务已暴露 /debug/pprof/ 端点、采样时程序真在干活、分析命令指向正确的 profile 类型——缺一不可，否则 go tool pprof 会返回空数据或报错。
为什么 import _"net/http/pprof" 后访问 /debug/pprof 返回 404
下划线导入只触发 init() 注册路由，但注册对象是 http.DefaultServeMux；如果你用了 http.NewServeMux()、Gin、Echo 或任何自定义 mux，它完全不生效。
- 用默认 mux：确保启动时传的是
nil，例如http.ListenAndServe(":6060", nil)，且该调用不能被覆盖 - 用自定义 mux：必须手动挂载，路径末尾的
/不能省——mux.Handle("/debug/pprof/", http.StripPrefix("/debug/pprof/", http.HandlerFunc(pprof.Index))) - Gin 用户别写
GET("/debug/pprof/*pprof", ...)，通配符不兼容 pprof 内部重定向逻辑，应改用gin.WrapH(http.DefaultServeMux) - 检查 curl -v http://localhost:6060/debug/pprof/ 是否返回 HTML 列表，不是 404 或超时
抓不到 CPU 数据？先确认这三件事
CPU profile 依赖操作系统定时信号（SIGPROF），不是快照，采样失败通常卡在这几个硬条件上：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 采样期间程序没真实运行：curl 请求发出后，服务必须正在处理请求或执行计算，空闲进程几乎不产生样本
- URL 中的
?没用引号包裹：go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30会被 shell 拆成多个参数，正确写法是加单引号：go tool pprof 'http://localhost:6060/debug/pprof/profile?seconds=30' - 容器或受限环境屏蔽了信号：Linux 上若进程被
prctl(PR_SET_NO_NEW_PRIVS, 1)锁定，或 Alpine 镜像缺少go tool pprof，都会导致采样失败
heap 和 allocs 完全不是一回事，选错就查偏了
/debug/pprof/heap 和 /debug/pprof/allocs 语义截然不同，混用会导致定位方向错误：
立即学习“go语言免费学习笔记（深入）”；
-
heap：只抓 GC 后存活对象（in-use），适合查内存泄漏——对象分配后一直没被回收。可加?gc=1强制 GC 再采样：curl 'http://localhost:6060/debug/pprof/heap?gc=1' -o heap.prof -
allocs：记录整个生命周期所有 malloc（total allocated），适合查高频小对象爆炸——比如循环里反复make([]byte, 1024)又立刻丢弃 - 命令不能互换：
go tool pprof http://localhost:6060/debug/pprof/heap和go tool pprof http://localhost:6060/debug/pprof/allocs分析目标完全不同 - 火焰图里如果
runtime.mallocgc占比高，别优化它——要顺着调用栈往上找是谁在频繁申请
交互式分析时 top 命令默认不显示真实热点
top 默认按 flat（自身耗时）排序，但 Go 很多函数只是中转，真正耗时在下游；直接看 top 结果容易漏掉关键路径：
- 先用
top快速扫一眼，再用top -cum看累加耗时（含子调用），能暴露“看似轻量但调用链深”的瓶颈函数 - 怀疑某函数时，用
list <function></function>查看每行代码的采样数，确认是哪一行在拖慢整体 -
web命令生成火焰图需本地装graphviz，Mac 用brew install graphviz，Windows 要加到 PATH - 生产环境务必限制
/debug/pprof/访问，它泄露 goroutine stack、堆分布甚至符号表，风险极高
