如何使用 Cython 把 Python 脚本编译成 pyd/so

第一步：安装 Cython

pip install cython

一般系统都自带，没有就装一下。

第二步：写 setup.py，编译

先来个测试脚本 hello.py：

def hello():    print("Hello World!")

同目录下建 setup.py：

from setuptools import setupfrom Cython.Build import cythonizesetup(    name='hello',    ext_modules=cythonize("hello.py", language_level="3"))

注：

• 加 language_level="3"，不然 Cython 默认按 Python 2 语义处理，运气不好可能会踩坑。

• 如果你的 Python 比较老（≤3.9），第一行得改成 from distutils.core import setup。3.12 之后 distutils 已经删了，只能用 setuptools。

在 setup.py 所在目录跑：

python setup.py build_ext --inplace

跑完后目录下会多出几个东西：

• hello.c — 中间生成的 C 文件，不发给别人可以删掉

• hello.cp312-win_amd64.pyd — 这就是编译好的模块（文件名里 cp312 是 Python 版本号，你实际的会根据环境不同）

清理中间文件：

# Windowsdel hello.c# Linux / Macrm hello.c

如果改完 hello.py 重新编译发现没生效，加 --force：

python setup.py build_ext --inplace --force

第三步：导入使用

同目录下写个 app.py：

from hello import hellohello()

python app.py，输出 Hello World!。搞定。

Windows 上报 Microsoft Visual C++ 14.0 or greater is required 怎么搞

完整报错长这样：

error: Microsoft Visual C++ 14.0 or greater is required.Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/...

错误提示点进去会让你装 Visual Studio，但那玩意太大了，装完几 G，纯属浪费。你只需要装 Build Tools。

直接去这里下：https://visualstudio.microsoft.com/visual-cpp-build-tools/

安装时勾选「C++ 生成工具」那项就行，装完重启一下终端，再跑编译命令就能过了。

或（直接安装Microsoft C++ Build Tools：Visual Studio Subscriptions 在下载页面搜索Build Tools for Visual Studio 2015，进行安装。）

附：多个文件一起编译

项目里要编译的不止一个 .py，可以这样写：

from setuptools import setupfrom Cython.Build import cythonizesetup(    name='my_project',    ext_modules=cythonize([        "module_a.py",        "module_b.py",        "utils/*.py",      # 也支持通配符    ], language_level="3"))