如何使用zig cc交叉编译Cython项目？求Hello World编译示例

完全可以用zig cc完成Cython项目的交叉编译，不需要搭建传统的多架构交叉编译工具链。zig cc内置了所有主流目标平台的libc实现、系统头文件与链接逻辑，可以直接替代gcc、clang完成编译链接工作。

以下流程以x86_64架构Linux宿主，交叉编译到aarch64（ARM64）架构Linux为例，其他目标平台仅需调整target参数即可。

前置准备 #

• 安装0.11.0及以上稳定版本的Zig，确保zig命令可在终端直接调用
• 宿主环境安装Cython、setuptools，版本无特殊要求
• 提前提取目标平台对应大版本的Python开发文件（头文件、so库stub），存放到本地独立目录，不要直接引用宿主平台的Python头文件，避免ABI不匹配

步骤1：编写示例代码 #

新建hello.pyx，写入官方示例内容：

def say_hello():
    print("Hello World from Cython!")

步骤2：编写构建配置 #

新建setup.py，写入标准Cython构建配置，注意指定目标平台Python头文件的路径：

from setuptools import setup
from Cython.Build import cythonize

# 假设提前把aarch64版本Python3.11的头文件存到了./target_py311/include/python3.11
TARGET_PY_INCLUDE = "./target_py311/include/python3.11"

setup(
    ext_modules=cythonize("hello.pyx"),
    include_dirs=[TARGET_PY_INCLUDE]
)

步骤3：配置编译环境变量 #

终端执行以下命令，指定用zig cc作为编译器，传入交叉编译目标参数，同时关闭宿主平台专属的编译优化选项：

export CC="zig cc -target aarch64-linux-gnu"
export CXX="zig c++ -target aarch64-linux-gnu"
export CFLAGS="-fPIC -O2"
export LDFLAGS="-fPIC"
# 指定生成的扩展模块后缀匹配目标平台
export SETUPTOOLS_EXT_SUFFIX=".cpython-311-aarch64-linux-gnu.so"

步骤4：执行交叉编译 #

运行构建命令，指定目标平台名称：

python setup.py build_ext --plat-name linux-aarch64 --inplace

编译完成后，当前目录会生成hello.cpython-311-aarch64-linux-gnu.so文件，把该文件拷贝到aarch64架构的目标设备上，确保设备安装了Python3.11版本，即可直接导入调用：

import hello
hello.say_hello()
# 输出 Hello World from Cython!

编译其他平台时，只需要替换环境变量里-target后面的字符串即可：

• 64位Windows：x86_64-windows-gnu
• 32位ARM Linux（硬浮点）：arm-linux-gnueabihf
• Apple Silicon macOS：aarch64-macos-none
• Intel架构macOS：x86_64-macos-none

注意：编译时引用的Python头文件大版本必须和目标设备运行的Python大版本完全一致，否则会出现模块加载失败的问题。zig cc会自动处理跨平台libc链接逻辑，不需要额外安装目标平台的gcc、binutils等工具链组件。

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