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 完全不是一回事。跑通流程容易，读对数据很难。