Go PGO 开了却看不出提升：用 default.pgo 和 -pgo=off 做可比排查

Go PGO 没有带来明显加速时，先不要急着怀疑编译器。最常见的原因是 CPU profile 没有覆盖真实生产负载，或者构建阶段没有把它应用到正确的主程序。把采样输入、源码版本和对照构建分开核对，通常比继续改业务代码更快找到原因。

先用生产实例和真实业务时段取得 CPU pprof，再确认 profile 放在正确的主程序目录并命中构建；最后用同一工作负载比较 PGO 与 -pgo=off。三者任一缺失，收益“不明显”都不能下结论。

• PGO 输入是 CPU pprof，不是 heap 或 goroutine profile。
• 多个 profile 合并前尽量保持采样时长一致，避免长样本在合并结果中被过度代表。
• PGO 和基线必须使用相同源码、参数与压测方式，才有可比性。

先确认 profile 真的代表生产负载

Go 文档建议优先从生产环境采集 profile。一个只在低峰期、单实例、单一接口上抓到的 30 秒样本，可能只描述了某个局部路径；它被用于整个服务时，编译器自然得不到足够有用的热点信息。微基准也不能直接代替服务画像，因为它只执行很小的一段代码。

排查时先记录三个维度：采样来自哪个实例、覆盖了哪些业务时段、请求类型是否接近真实比例。若服务存在读写两类明显不同的流量，应分别判断是否要构建两个版本，或按业务占比合并样本，而不是随手拿一个实例的 profile 代表全站。

合并采样时把时间和工作负载对齐

需要汇总多个实例或多个时段时，可以使用 pprof 工具生成合并 profile：

go tool pprof -proto instance-a.pprof instance-b.pprof > merged.pprof

这里的合并本质上是样本相加。如果一个文件采了 30 秒，另一个采了 5 分钟，后者会在结果中占更大权重。要比较不同实例，尽量采用相同的 wall duration，并在记录中留下实例、时段和流量类型。若 profile 来自不同业务，合并前还要确认它们确实属于同一个二进制和相近的代码路径。

采样文件准备好后，不要只看文件存在就认为它有效。确认它是 CPU pprof，且热点与线上请求路径有关系；heap、mutex 或 goroutine profile 用于诊断其他问题，不能直接作为 Go PGO 的输入。

再确认构建确实吃到了 profile

最省事的约定是把 CPU pprof 命名为 default.pgo，放在被构建主程序的目录中。Go 的自动模式会发现它：

go build -pgo=auto -o bin/service ./cmd/service
go build -pgo=off  -o bin/service-baseline ./cmd/service

第二条命令是对照基线，不是生产发布参数。若不想把 profile 放进源码目录，也可以明确指定 go build -pgo=/path/to/service.pprof。注意显式路径会应用到这次命令涉及的所有主程序；一次命令同时构建多个不同二进制时，通常应拆成多次构建并分别使用各自 profile。

再做两项静态核对：一是 default.pgo 是否确实位于主程序目录，而不是某个依赖包目录；二是 profile 与当前源码是否发生了大规模重命名或跨包移动。Go PGO 对小幅源码偏移通常能平滑退化，但大量函数改名、迁包或新功能首次上线，都可能让旧 profile 覆盖不到新热点。

用同一工作负载判断收益而不是凭感觉

最后固定一份可重复的请求集或压测脚本，分别运行 PGO 二进制和基线二进制。保持机器规格、并发数、输入数据、预热方式和测量窗口一致，至少重复几轮，再看吞吐、延迟和 CPU 使用是否同时改善。不要把一次冷启动、不同缓存状态或不同流量比例造成的波动归因给 PGO。

如果 PGO 版本和基线几乎没有差异，按这个顺序回看：profile 是否真的采自繁忙实例；采样是否覆盖高峰和主要请求；合并时长是否失衡；构建是否用了正确的主程序和 profile；源码是否已大幅重构。若只是新代码路径尚未出现在 profile 中，应先让它经过真实流量，再收集下一轮 profile。

Go PGO 的收益不是固定承诺，文档给出的基准范围也不代表每个服务的结果。把 profile 当作版本化构建输入，持续采集、对照和更新，才是比“打开开关看一次”更可靠的使用方式。

相关问题

PGO 能不能直接使用 heap profile？不能。Go 编译器面向 PGO 期待的是 CPU pprof；heap profile 适合分析分配和内存占用。

同一个 profile 能给多个 GOOS/GOARCH 构建吗？格式可以跨配置使用，但平台相关源码如果不同，就无法完整匹配，收益可能下降。

为什么开启 PGO 后构建更慢？首次使用 profile 时，依赖图中的包可能需要重新构建；后续相同 profile 的增量构建通常可以利用缓存。

资料入口：Go 官方 PGO 文档、Go 官方诊断工具说明。