ubuntu gcc如何编译Python扩展

在Ubuntu上使用GCC编译Python扩展模块

想在Ubuntu上为Python提速，或者调用一些底层的C库？自己动手编译一个扩展模块是个不错的选择。整个过程其实就像搭积木，一步步来，并不复杂。下面就来拆解一下具体的步骤。

1. 安装必要的软件包

工欲善其事，必先利其器。第一步，得确保系统里已经备好了Python开发头文件和GCC编译器。打开终端，执行下面这两条命令就搞定了：

sudo apt update
sudo apt install python3-dev gcc

这里有个小提示：如果你还在为已经停止支持的Python 2编译扩展（通常不推荐这么做），那么需要安装的是 python-dev 和 gcc。不过，现在的主流和未来都在Python 3这边。

2. 编写扩展模块的代码

接下来是核心部分：编写C语言源代码。创建一个新的 .c 文件，比如就叫它 examplemodule.c，然后把你的C函数逻辑写进去。这里就是发挥你C语言功底的地方了。

3. 编写setup.py脚本

光有C代码还不够，需要一个“建造说明书”告诉Python怎么把它编译成模块。这个说明书就是 setup.py 脚本。它利用Python自带的 distutils 或更强大的 setuptools 来配置编译过程。

下面是一个最基础的 setup.py 示例，你可以以此为模板：

from distutils.core import setup, Extension

module = Extension('examplemodule', sources=['examplemodule.c'])

setup(name='ExampleModule',
      version='1.0',
      description='This is a demo package',
      ext_modules=[module])

看明白了吗？关键就在 Extension 这个对象里：‘examplemodule’ 是你未来在Python中导入时使用的模块名，而 sources 参数则指明了源代码文件是哪个。

4. 编译扩展模块

说明书准备好了，就可以开始“施工”了。在终端里，切换到包含 setup.py 的目录，运行这条命令：

python3 setup.py build

命令执行后，会生成一个 build 目录，编译好的 .so 文件（Linux下的动态库）就躺在里面。这意味着编译环节已经成功了。

5. 安装扩展模块（可选）

如果你希望这个模块能像普通Python包一样，在任何地方都能被导入使用，可以把它安装到系统环境中。命令也很简单：

sudo python3 setup.py install

执行之后，你的扩展模块就被正式“收纳”进Python的大家庭了。

6. 测试扩展模块

最后一步，当然是验收成果。打开Python解释器，尝试导入你的模块：

import examplemodule

如果没有任何错误提示，恭喜你！这意味着扩展模块已经成功编译并可以正常使用了。接下来，就可以尽情调用你写在C代码里的那些高性能函数了。

进阶须知

以上是最简化的流程。实际上，如果遇到更复杂的场景，比如模块依赖额外的头文件路径、库文件或者第三方C库，该怎么办？别担心，Extension 对象提供了丰富的参数（如 include_dirs, library_dirs, libraries）来应对这些情况。

另外，对于更现代、更复杂的项目，尤其是涉及C++时，你可能需要考虑放弃基础的 distutils，转而使用功能更强大的 setuptools。社区里还有一些非常优秀的工具，比如 pybind11，它能极大地简化C++代码与Python之间的接口绑定工作，让整个过程更加优雅高效。

说到底，从简单的模块入手，理解了这个基本流程，再去探索那些高级选项和工具，路就会越走越宽了。