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