配置python的c/c++扩展需先安装对应系统的编译器工具链:windows推荐msvc,macos安装xcode命令行工具,linux安装gcc和python3-dev;接着确保setuptools为最新并验证distutils能调用编译器;然后按python c api编写扩展代码(如hello.c)并创建setup.py定义扩展模块;运行python setup.py build_ext --inplace生成可导入的二进制文件;最后可通过cython或pybind11等工具简化复杂项目开发。

要在 Python 环境中配置 C/C++ 扩展支持,核心是搭建正确的编译工具链并确保 Python 能调用本地编译器构建扩展模块。常见使用场景包括开发高性能模块、封装已有 C/C++ 代码或使用如 Cython 加速计算。下面分关键步骤说明如何配置。
安装合适的编译器工具链
Python 在构建 C/C++ 扩展时依赖系统编译器。不同操作系统需要不同的工具:
- Windows:推荐安装 Microsoft Visual C++ Build Tools 或完整版 Visual Studio。也可使用 MinGW-w64,但官方更推荐 MSVC。安装后确保环境变量 PATH 包含编译器路径。
-
macOS:需安装 Xcode 命令行工具,终端运行
xcode-select --install即可完成。 -
Linux:安装 GCC 和 Python 开发包,例如在 Ubuntu 上执行:
sudo apt update && sudo apt install build-essential python3-dev
确认 Python 的 distutils 和 setuptools 配置正确
Python 使用 distutils 和 setuptools 来编译和打包扩展。大多数情况下它们已随 Python 安装,但仍需验证:
- 确保已安装最新版
setuptools:pip install --upgrade setuptools - 测试能否正常调用编译器,在项目中创建一个简单的
setup.py文件示例:
from setuptools import setup, Extension
<p>module = Extension('hello', sources=['hello.c'])</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记(深入)</a>”;</p><p>setup(name='HelloExt',
version='0.1',
description='A simple C extension',
ext_modules=[module])
若运行 python setup.py build 成功生成构建目录,则表示基础配置已通。
编写和编译 C/C++ 扩展模块
编写扩展需遵循 Python C API 规范。以一个简单 C 文件 hello.c 为例:
#include <Python.h>
<p>static PyObject<em> say_hello(PyObject</em> self, PyObject* args) {
printf("Hello from C!\n");
Py_RETURN_NONE;
}</p><p>static PyMethodDef HelloMethods[] = {
{"say_hello", say_hello, METH_NOARGS, "Say hello."},
{NULL, NULL, 0, NULL}
};</p><p>static struct PyModuleDef hellomodule = {
PyModuleDef_HEAD_INIT,
"hello",
NULL,
-1,
HelloMethods
};</p><p>PyMODINIT_FUNC PyInit_hello(void) {
return PyModule_Create(&hellomodule);
}
完成后运行构建命令:
python setup.py build_ext --inplace
成功后会在当前目录生成 hello.cpython-*.so(Linux/macOS)或 hello.pyd(Windows),可直接在 Python 中导入使用:import hello; hello.say_hello()
使用现代工具简化流程(可选)
对于复杂项目,可借助以下工具提升效率:
-
Cython:允许用类 Python 语法写扩展,自动转为 C 代码。安装
pip install cython后可在setup.py中指定.pyx文件。 - pybind11:轻量级头文件库,简化 C++ 与 Python 的绑定。配合 CMake 可实现跨平台构建。
- poetry 或 meson:替代传统 setup.py,提供更清晰的构建配置方式。
基本上就这些。只要编译器到位、Python 开发头文件齐全,再按标准接口编写模块,就能顺利启用 C/C++ 扩展支持。过程中注意版本兼容性,尤其是 Python 3.x 的 Unicode 和对象管理机制变化较多,需参考官方文档调整代码。










