Go 自带性能分析工具链，启用 pprof 需导入 "net/http/pprof" 并启动独立 HTTP 服务（如 localhost:6060），通过 /debug/pprof/profile（CPU）和 /debug/pprof/heap（内存）获取数据，再用 go tool pprof 离线分析。
Go 自带一套轻量、开箱即用的性能分析工具链，不需要额外安装第三方包就能做 CPU、内存、goroutine、block、mutex 等维度的 profiling —— 关键是得正确启用 net/http/pprof 并暴露端口。
如何启用 pprof HTTP 服务
最常用方式是在主程序中启动一个独立的 HTTP server 专门服务 pprof 数据。它不干扰主业务逻辑，且支持实时抓取快照。
- 必须显式导入
"net/http/pprof"（该包注册了多个 handler） - 推荐使用独立监听地址（如
localhost:6060），避免和主服务端口混用 - 生产环境务必限制访问来源（如通过反向代理加白名单或 auth），因为 pprof 暴露大量运行时信息
import (
"log"
"net/http"
_ "net/http/pprof" // 注意：这是空导入，仅用于注册 handler
)
func main() {
go func() {
log.Println("pprof server started on :6060")
log.Fatal(http.ListenAndServe("localhost:6060", nil))
}()
// ... your main app logic
}
怎么抓取 CPU 和 heap profile
pprof 通过 HTTP 接口提供原始 profile 数据，需用 go tool pprof 解析。不同 profile 类型采集方式和耗时差异很大。
-
/debug/pprof/profile默认采集 30 秒 CPU profile（会阻塞请求，慎在生产高频接口上直接调） -
/debug/pprof/heap返回当前堆内存分配快照（无需等待，可随时 GET） - 想缩短 CPU 采集时间，加
?seconds=5参数，例如：curl "http://localhost:6060/debug/pprof/profile?seconds=5" > cpu.pprof - heap profile 支持按分配大小/活跃对象过滤，用
?gc=1获取 GC 后的存活对象数据
常见错误：本地无法访问 /debug/pprof 页面
不是 pprof 没生效，而是服务绑定地址不对或被防火墙拦截。
立即学习“go语言免费学习笔记（深入）”；
- 检查是否绑定了
0.0.0.0:6060（对外暴露）而非localhost:6060（仅本机可访问） - Docker 容器中要确保
-p 6060:6060映射，并在代码里监听:6060而非localhost:6060 - 某些 IDE（如 Goland）默认禁用调试端口，需手动允许或改用终端运行
-
浏览器直接访问
http://localhost:6060/debug/pprof/应看到文本列表；如果返回 404，说明 pprof handler 未注册（确认空导入已写、没拼错包名）
怎么离线分析 pprof 文件
拿到 cpu.pprof 或 heap.pprof 后，用 Go 自带工具交互分析：
- 查看火焰图：
go tool pprof -http=:8080 cpu.pprof（自动打开浏览器） - 查看 top 函数：
go tool pprof cpu.pprof进入交互模式后输入top - 对比两个 heap profile 找内存增长点：
go tool pprof -base base.heap.pprof new.heap.pprof - 注意：profile 文件是二进制格式，不要用文本编辑器打开，也不要用
cat查看
pprof 的真正门槛不在启动，而在理解采样原理和指标含义——比如 CPU profile 是基于周期性栈采样，不代表函数执行总时长；heap profile 中 inuse_space 和 alloc_space 完全不是一回事。跑通流程容易，读对数据很难。
