必须传入未strip的原始二进制文件，否则pprof无法映射地址到函数名，导致火焰图显示[unknown]或runtime.mcall；正确命令为go tool pprof ./myapp http://...，并用readelf -S验证debug符号存在。
pprof 能定位热路径，但前提是它能看到你的函数名——90% 的“找不到热点”问题，都卡在没传对二进制文件或构建时剥离了符号。
go tool pprof 必须带原始可执行文件才能解析函数名
Go 的 CPU profile（/debug/pprof/profile）只记录程序计数器地址，不存函数名。pprof 需要原始二进制里的 DWARF 符号表做地址映射。
- 错误写法：
go tool pprof http://localhost:8080/debug/pprof/profile?seconds=30→ 输出全是[unknown]或runtime.mcall - 正确写法：
go tool pprof ./myapp http://localhost:8080/debug/pprof/profile?seconds=30（./myapp是你用go build生成的、未 strip 的二进制） - 验证符号是否在：运行
readelf -S ./myapp | grep debug，有输出才说明符号表可用；或者file ./myapp显示with debug_info - CI/CD 中建议：dev/test 环境保留符号，prod 环境用
-ldflags="-s -w"，但必须归档一份带符号的 debug 版本备用
采样前确保业务真在跑，且避开启动抖动
热路径不是静态代码，是正在被高频执行的逻辑。刚启服务就采，大概率抓到初始化代码或空闲调度器。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 压测接口需稳定在目标 QPS 至少 1–2 分钟后再开始采样
- 采样时长至少 30 秒：
go tool pprof ./myapp http://localhost:8080/debug/pprof/profile?seconds=30；低于 15 秒基本不可信 - 如果
top里还是看不到业务函数，立刻切到/debug/pprof/goroutine?debug=2，搜索chan receive、semacquire、select—— 大量重复出现的行号（如handler.go:47）往往就是阻塞或泄漏源头
火焰图里盯宽度，不是颜色或高度
火焰图不是调用图，每个矩形的宽度 = 该函数及其子调用占用 CPU 时间占比。优化优先级由宽决定，不是顶部有没有、颜色深不深。
- 生成可靠火焰图的稳态路径：
go tool pprof -raw -lines ./myapp cpu.out > stacks.txt./flamegraph.pl stacks.txt > flame.svg（-raw是关键，缺了flamegraph.pl无法识别格式） - 别依赖
go tool pprof -http=:8080点 Web UI 的「Flame graph」按钮——它背后调用dot，极易因环境缺失静默失败 - 常见假热点：
log.Printf、time.Now()在高并发下会扁平铺满火焰图底部；这不是算法问题，是日志/时间调用本身成了瓶颈，优先删或加条件判断（如if level >= Debug { zap.Sugar().Debugw(...) }）
最常被跳过的一步：确认框架是否真的把 /debug/pprof/ 挂载成功。Gin/Echo/Chi 默认不共享 http.DefaultServeMux，只写 import _ "net/http/pprof" 是无效的——必须手动桥接路由，否则连 curl http://localhost:8080/debug/pprof/ 都返回 404。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
