Go 中启用 CPU Profiling 需调用 pprof.StartCPUProfile 启动并确保在进程退出前用 StopCPUProfile 停止；推荐 defer + 信号监听，HTTP 服务可借 /debug/pprof/profile 按需采集；分析时必须使用原始可执行文件，注意 off-CPU 场景无法捕获。
如何在 Go 程序中启用 CPU Profiling
Go 自带的 pprof 包支持开箱即用的 CPU 采样，不需要额外依赖。关键在于：必须调用 pprof.StartCPUProfile 启动，并在退出前调用 pprof.StopCPUProfile —— 否则不会生成任何数据。
- 启动前需确保输出文件可写（如
/tmp/cpu.pprof），且路径存在 - 不能在
main()返回后才调用StopCPUProfile，否则进程已退出，写入失败 - 推荐用
defer配合信号监听（如os.Interrupt）来保证优雅停止 - 采样默认频率是 100Hz（每 10ms 一次），可通过
runtime.SetCPUProfileRate(500)提高精度（注意：过高会增加性能开销）
HTTP 服务中通过 pprof HTTP 接口获取 CPU Profile
对长期运行的服务（如 Web 服务），更常用的是通过内置 HTTP 接口按需采集，避免修改源码。前提是已导入并注册了 net/http/pprof。
- 确保已执行
import _ "net/http/pprof"，且该路由已注册（通常只要 mux 路由包含/debug/pprof/即可） - 发起采集命令：
wget -O cpu.pprof "http://localhost:8080/debug/pprof/profile?seconds=30"，其中seconds=30表示持续采样 30 秒 - 若返回空文件或
404，检查是否漏掉import _ "net/http/pprof"，或端口/路径是否被防火墙或反向代理拦截 - 不建议在生产环境长时间开启（如 >60s），采样本身会带来约 5–10% 的额外 CPU 开销
分析 cpu.pprof 文件的常用命令和误区
拿到 cpu.pprof 文件后，用 go tool pprof 分析。但很多用户卡在「打开后全是空白」或「显示 no samples」——本质是符号未解析或二进制不匹配。
- 必须使用与 profile 文件对应的原始可执行文件：例如用
./myserver采集的 profile，就得用同一份./myserver（非重新编译过的）来分析 - 常见错误命令：
go tool pprof cpu.pprof→ 缺少二进制，无法解析函数名；正确写法：go tool pprof ./myserver cpu.pprof - 交互式查看 top 函数：
top；火焰图生成：go tool pprof -http=:8081 ./myserver cpu.pprof（需安装graphviz） - 如果看到大量
runtime.mcall或runtime.futex占比高，往往说明协程阻塞严重（如锁竞争、channel 等待），不是 CPU 密集型问题
go tool pprof -http=:8081 ./myserver cpu.pprof
CPU Profiling 容易被忽略的关键限制
CPU profiling 只能捕获正在运行（on-CPU）的 goroutine 栈，对 I/O 等待、channel 阻塞、GC 暂停等 off-CPU 场景完全无感知。它告诉你“CPU 花在哪”，但不回答“为什么卡住”。
立即学习“go语言免费学习笔记（深入）”；
- goroutine 大量休眠时，profile 里可能几乎看不到你的业务函数，反而全是
runtime.gopark—— 这时该换用goroutine或traceprofile - CGO 调用中的 C 函数默认不被采集（除非用
runtime.LockOSThread()并开启GODEBUG=cgocheck=0，但不推荐） - 交叉编译生成的二进制（如 macOS 编译 Linux 二进制）可能导致符号表丢失，分析时函数名显示为
???
