pybind11绑定C++函数两种构建方式的性能差异原因探究

造成两种构建方式性能差异的核心原因是编译配置与优化等级的不同，具体可以拆解为以下几点：

1. 编译优化等级的差异 #

你的CMake配置明确设置了CMAKE_BUILD_TYPE Release，这会让编译器自动启用最高级别的优化选项（比如GCC/Clang的-O3、MSVC的/O2），同时定义NDEBUG宏关闭断言机制。这些优化会对sumf函数里的循环、浮点运算（std::log）做深度优化：比如循环展开、指令矢量化、数学函数的内联替换，直接提升计算密集型代码的执行效率。

而pip通过setuptools构建时，默认的编译优化等级通常更低（比如默认-O2甚至部分场景下保留调试信息），不会自动启用-O3级别的优化。这也是你的测试中sumf函数耗时差异更明显的原因——内存分配的优化空间有限，而计算密集型代码对优化等级的敏感度极高。

2. pybind11的构建配置差异 #

你的CMake脚本明确指定了pybind11的版本（v2.10.4），并通过pybind11_add_module宏处理绑定模块的编译逻辑，该宏会自动添加pybind11特有的优化参数（比如-fvisibility=hidden、针对Python ABI的适配选项），确保生成的模块在性能和兼容性上达到最优。

而pip使用的python_example仓库默认的setuptools配置，可能没有显式设置这些pybind11专属的优化参数，或者依赖的pybind11版本与CMake中使用的不一致，导致编译出的模块性能打折扣。

3. 构建系统的默认行为差异 #

CMake在Release模式下会关闭调试信息生成（-g参数），减少模块体积的同时避免调试逻辑对运行时性能的微小影响；而setuptools默认构建可能会保留部分调试符号，或者没有完全关闭调试相关的编译选项，间接降低了运行速度。

验证方法 #

你可以通过以下方式确认差异根源：

• 执行pip install ./ -v查看pip构建时的编译命令，对比CMake生成的编译命令（可通过cmake --build . --verbose查看），重点看优化参数（-O系列）、是否定义NDEBUG等；
• 修改setuptools的配置文件（比如setup.py），手动添加-O3、-DNDEBUG等参数，重新构建后测试性能，看是否与CMake构建的结果接近。

内容的提问来源于stack exchange，提问作者Damons