必须加--enable-optimizations才能启用PGO,否则仅为普通编译、性能无提升;该参数触发三步流程:编译临时解释器→运行benchmark收集profile→重编译正式版,并隐式启用LTO(GCC≥9/Clang≥10)。

configure 时必须加 --enable-optimizations
这是启用 PGO 的唯一开关,不是可选项。不加它,后续所有编译步骤都不会触发 PGO 流程。--enable-optimizations 实际上是三步打包操作:先用默认参数编译一个临时解释器,再用它跑 benchmark(位于 Tools/scripts/run_profile_task.py),最后用收集到的 profile 数据重新编译正式版。漏掉这一步,就等于没开 PGO。
常见错误现象:make -j$(nproc) 跑完直接能用,但 python3.11 -c "import sys; print(sys.version)" 显示的版本字符串里没有 PGO 字样;实测性能与未优化版本几乎无差异。
- 它隐式启用了
-flto(LTO),但仅限 GCC/Clang 默认支持 LTO 的版本(GCC ≥ 9,Clang ≥ 10) - 若系统 GCC 版本太旧(如 CentOS 7 默认的 GCC 4.8),
--enable-optimizations会静默跳过 LTO,只做 PGO - 不能和
--without-pymalloc共存,后者会破坏 PGO 所需的内存分配行为
OpenSSL 路径必须显式指定,否则 _ssl 模块编译失败
PGO 编译过程中会反复调用刚生成的临时解释器,而该解释器需要加载 _ssl 模块才能跑完 HTTPS 相关 benchmark。如果系统 OpenSSL 头文件或库路径不在默认搜索路径中(比如你手动装了新版 OpenSSL 到 /usr/local/openssl),configure 阶段不会报错,但 make 会在链接 _ssl 时失败,报类似 undefined reference to SSL_CTX_set_ciphersuites 的错误。
正确做法是在 configure 命令中显式传参:
立即学习“Python免费学习笔记(深入)”;
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
./configure --enable-optimizations \ --prefix=/usr/local/python3.11 \ --with-openssl=/usr/local/openssl \ --with-openssl-rpath=auto
-
--with-openssl告诉 Python 去哪找openssl/ssl.h和libssl.so -
--with-openssl-rpath=auto让生成的二进制在运行时能自动定位到该路径下的动态库,避免部署后ImportError: libssl.so.1.1: cannot open shared object file - 不要依赖
LD_LIBRARY_PATH或/etc/ld.so.conf—— PGO 的 benchmark 运行阶段不读这些
make 过程中不能中断,且需保证磁盘空间充足
PGO 编译实际执行两次完整构建:第一次生成带 instrumentation 的临时解释器(体积比普通版大 30%~50%),第二次用 profile 数据重编译。整个过程会生成大量中间文件,build/ 目录峰值占用常超 2 GB。
容易踩的坑:
- 在 CI 环境或容器中编译时,
/tmp分区空间不足,make在 profile 收集阶段突然失败,错误信息模糊,只显示Segmentation fault或Aborted - 手动
Ctrl+C中断make后重试,会导致build/下残留部分 instrumented object 文件,再次make时链接器混用新旧目标,出现符号重复定义或 ABI 不一致 - 某些发行版(如 openEuler 22.03)默认启用
gcc -fPIE,与 PGO 的 instrumentation 冲突,需额外加CFLAGS="-no-pie"
LTO 在链接阶段吃内存,4 GB RAM 机器大概率 OOM
--enable-optimizations 触发的 LTO 会让链接器(ld 或 lld)把所有 .o 文件的 LLVM IR 加载进内存统一优化。实测在 Python 3.11 编译中,ld 进程 RSS 峰值可达 3.2 GB。
如果你的机器只有 4 GB RAM,make 很可能卡死在 Linking Python 步骤,dmesg 里能看到 Out of memory: Kill process。解决方法只有两个:
- 加
swap:至少 2 GB,用dd if=/dev/zero of=/swapfile bs=1G count=2 && mkswap /swapfile && swapon /swapfile - 换用内存更友好的链接器:Clang +
lld比 GNUld少占约 40% 内存,加CC=clang LD=ld.lld到 configure 前缀即可
别指望通过 make -j1 降低内存压力——LTO 是单线程链接行为,-j 参数对它无效。

















