pprof需满足三条件：暴露/debug/pprof/端点、采样时有真实负载、分析命令匹配profile类型；下划线导入仅对http.defaultservemux生效，自定义mux需手动注册；抓cpu数据须用单引号包裹url、确保cpu活动、必要时调高采样率；heap查内存泄漏，allocs查高频分配；核心是先明确问题类型再选对应profile。
pprof 不是“开了就能用”的工具，它必须满足三个硬条件：服务已暴露 /debug/pprof/ 端点、采样期间程序真实运行了目标负载、分析命令指向正确的 profile 类型和参数——缺一不可，否则看到的全是空数据或误导性结果。
为什么 _ "net/http/pprof" 导入后还是 404？
下划线导入只是触发 init() 函数注册路由，但注册到哪、是否生效，取决于你用的 HTTP 多路复用器：
- 用
http.DefaultServeMux（即传nil）时，_ "net/http/pprof"确实能自动挂载，但必须确保http.ListenAndServe(":6060", nil)在后台跑着，且没被其他http.ListenAndServe覆盖 - 用自定义
http.ServeMux或框架（如 Gin），_ "net/http/pprof"完全无效，必须手动注册：mux.Handle("/debug/pprof/", http.StripPrefix("/debug/pprof/", http.HandlerFunc(pprof.Index))) - 路径末尾斜杠不能省：
/debug/pprof返回 404，/debug/pprof/才显示索引页
go tool pprof 抓不到 CPU 数据？检查这三件事
CPU profile 默认采样 30 秒，但很多新手卡在第一步就失败，原因很具体：
- URL 中的
?必须用单引号包裹，否则 shell 会把seconds=30当作命令参数解析：go tool pprof 'http://localhost:6060/debug/pprof/profile?seconds=30' - 采样期间程序必须有实际 CPU 活动，纯 sleep 或阻塞 I/O 不会产生样本；可加个
for {}或压测请求来触发 - Go 1.21+ 默认启用异步抢占，但某些低频循环仍可能逃过采样；若始终无数据，改用
runtime.SetCPUProfileRate(1000000)强制每微秒采样一次（仅调试用）
heap 和 allocs 到底该看哪个？
两者完全不是一回事，选错直接定位错方向：
-
heap是当前存活对象的内存占用（in-use），适合查内存泄漏：对象分配后一直没被 GC 回收 -
allocs是整个生命周期累计分配量（total allocated），适合查高频小对象爆炸：比如反复make([]byte, 1024)却立刻丢弃 - 命令差异明显：
go tool pprof http://localhost:6060/debug/pprof/heapvsgo tool pprof http://localhost:6060/debug/pprof/allocs - 想看堆中具体类型分布？进 pprof 后执行：
top -cum→list runtime.mallocgc→ 再web火焰图里点开 malloc 调用链
真正难的不是命令怎么敲，而是得清楚你在怀疑什么：是响应变慢（CPU）、OOM（heap）、GC 频繁（allocs），还是 goroutine 堆积（goroutine）——pprof 只反馈数据，不替你提问。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
