go tool pprof 是 profile 数据解析器，需输入合法 .pb.gz 文件或 HTTP 端点；本地文件适合离线分析，HTTP 地址需启用 net/http/pprof 且 URL 需引号包裹参数；不同 profile 类型对应不同 endpoint 和语义；交互式中优先用 top、list、web；采样机制决定数据非全量，CPU 默认 10ms/次，heap 默认不 GC，allocs 记录所有分配。
go tool pprof 不是“运行就出图”的傻瓜工具，它本质是一个 profile 数据解析器 —— 输入必须是合法的 .pb.gz 文件或可访问的 HTTP 端点，否则直接报错退出。
pprof 命令行输入源怎么选：文件 vs HTTP 地址
关键区别在于数据来源是否实时、是否可控：
- 用本地文件（如
cpu.prof）：适合离线复现、反复分析、CI 流水线中固化检查；但前提是得先拿到 profile 文件，不能边跑边看 - 用 HTTP 地址（如
http://localhost:6060/debug/pprof/profile?seconds=30）：适合调试线上服务，但要求目标进程已启用net/http/pprof，且端口可通、路径末尾有/（漏掉会 404） - URL 中的
?必须用单引号或双引号包裹，否则 shell 会把seconds=30当作独立参数，导致请求失败 - 首次执行时卡在 “Fetching profiles…” 是正常现象；若持续超过 10 秒，优先检查：
curl -v http://localhost:6060/debug/pprof/是否返回 HTML 列表
常见 profile 类型对应命令写法
不同分析目标，要调用不同 endpoint，参数也影响语义：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- CPU 分析：
go tool pprof http://localhost:6060/debug/pprof/profile?seconds=15—— 默认 30 秒，可显式缩到 15 秒减少干扰 - 当前堆内存（in-use）：
go tool pprof http://localhost:6060/debug/pprof/heap—— 只抓此刻存活对象，不反映历史分配压力 - 累计内存分配（allocs）：
go tool pprof http://localhost:6060/debug/pprof/allocs—— 找内存暴涨源头更有效，但数据量大、采样开销略高 - 阻塞分析（block）：
go tool pprof http://localhost:6060/debug/pprof/block—— 需程序中真有 channel recv/send、mutex lock 等阻塞行为，否则样本为空 - goroutine 快照：
go tool pprof http://localhost:6060/debug/pprof/goroutine?debug=2—— 加debug=2后输出格式等同 panic 堆栈，方便 grep 或日志系统识别
交互式终端里最该记住的三个命令
进到 pprof> 提示符后，别急着敲 web，先确认数据有没有真正捕获到：
立即学习“go语言免费学习笔记（深入）”；
-
top：默认按flat排序，只看函数自身耗时，适合快速定位热点函数；若发现某函数flat%很低但cum%很高，说明它只是个“中转站”，真正耗时在它调用的下游 -
list function_name：比如list main.handleRequest，能定位到具体哪一行代码在分配内存或循环计算，比top更细一层 -
web：生成火焰图，但注意它依赖本地dot工具（Graphviz），macOS 上需brew install graphviz，Linux 上常缺graphviz包，装不上就卡住不动
容易被忽略的采样机制细节
pprof 的数据不是“全量记录”，而是周期性采样，这意味着：
- CPU profile 默认每 10ms 采一次栈，即 100Hz；太短（如 1ms）会导致性能抖动，太长（如 100ms）可能错过短时尖峰
- heap profile 默认不触发 GC，所以
/debug/pprof/heap返回的是“带垃圾的快照”；加?gc=1参数才会先 GC 再采样，更反映真实存活压力 - allocs profile 记录所有分配动作，包括立刻被回收的小对象，因此数值常远大于 heap；别拿 allocs 的 MB 数直接对标内存泄漏
- profile 文件本身是二进制协议缓冲区（
.pb.gz），不能用文本编辑器打开，也不建议用cat或head查看，会乱码
