使用 Windows 编译 Rust Python 扩展以支持 macOS-Python教程-PHP中文网

使用 Windows 编译 Rust Python 扩展以支持 macOS

花韻仙語

发布： 2025-08-24 22:48:16

原创

650人浏览过

使用 windows 编译 rust python 扩展以支持 macos

在 Windows 环境下，无需购买 Mac 设备，即可编译 Rust 编写的 Python 扩展，使其能在 macOS 上运行的方法。主要思路是利用交叉编译技术，结合 Rust 的跨平台特性，以及 Python 的通用性，实现目标平台的兼容。

交叉编译的原理与优势

交叉编译是指在一个平台上编译代码，生成可在另一个平台上运行的可执行文件或库。这在嵌入式开发、移动应用开发等场景中非常常见，因为开发环境往往与目标运行环境不同。Rust 语言本身就具有良好的跨平台特性，配合合适的工具链，可以轻松实现交叉编译。

实现步骤

以下是在 Windows 上编译 Rust Python 扩展以支持 macOS 的步骤：

安装 Rust 工具链:

立即学习“Python免费学习笔记（深入）”；

首先，确保已经安装了 Rust 编程语言和 Cargo 包管理器。如果还没有安装，可以访问 https://www.php.cn/link/1d60e7b563919b58c33441f825b64bd1 下载并安装。
添加 macOS 目标平台:

使用 rustup 命令添加 macOS 目标平台。这会下载必要的工具链和库文件。
```
rustup target add x86_64-apple-darwin
```
登录后复制
如果你的目标架构是 Apple Silicon (M1/M2 等)，则需要添加 aarch64-apple-darwin 目标：
```
rustup target add aarch64-apple-darwin
```
登录后复制
配置 Cargo.toml:

在你的 Rust 项目的 Cargo.toml 文件中，需要配置一些选项来指定编译目标平台。特别是，需要确保 crate-type 设置为 cdylib，以便生成动态链接库（.dylib 文件），这是 Python 扩展所需要的。
```
[lib]
name = "your_extension_name"
crate-type = ["cdylib"]
```
登录后复制
设置链接器:

你需要一个能够链接 macOS 二进制文件的链接器。通常，你需要安装 llvm 工具链，并将其配置为 Rust 的链接器。这可以通过安装 llvm 并设置环境变量来实现。具体步骤取决于你使用的构建系统，例如 msys2 或 chocolatey。

火山翻译
火山翻译，字节跳动旗下的机器翻译品牌，支持超过100种语种的免费在线翻译，并支持多种领域翻译

193

查看详情

例如，使用 msys2 安装 llvm：
```
pacman -S mingw-w64-x86_64-llvm
```
登录后复制
然后，设置环境变量 CC 和 CXX 指向 llvm 的编译器：
```
export CC="clang"
export CXX="clang++"
```
登录后复制
构建项目:

使用 Cargo 构建项目，指定目标平台。
```
cargo build --target x86_64-apple-darwin --release
```
登录后复制
或者，对于 Apple Silicon：
```
cargo build --target aarch64-apple-darwin --release
```
登录后复制
这会在 target/<target>/release 目录下生成 .dylib 文件。
创建 Python 包:

将生成的 .dylib 文件复制到你的 Python 项目中，并创建一个 setup.py 文件来构建 Python 包。setup.py 文件应该包含构建扩展模块的指令。使用 PyO3 的话，通常 Cargo.toml 会帮你处理好。
打包和分发:

使用 python setup.py sdist bdist_wheel 命令生成可分发的 Python 包。

示例代码 (Cargo.toml)

[package]
name = "my_rust_extension"
version = "0.1.0"
edition = "2021"

[lib]
name = "my_rust_extension"
crate-type = ["cdylib"]

[dependencies]
pyo3 = { version = "0.20", features = ["extension-module"] }

登录后复制

示例代码 (src/lib.rs)

use pyo3::prelude::*;

#[pyfunction]
fn add(a: i32, b: i32) -> i32 {
    a + b
}

#[pymodule]
fn my_rust_extension(_py: Python, m: &PyModule) -> PyResult<()> {
    m.add_function(wrap_pyfunction!(add, m)?)?;
    Ok(())
}

登录后复制

示例代码 (setup.py)

from setuptools import setup, Extension

setup(
    name="my_rust_extension",
    version="0.1.0",
    ext_modules=[
        Extension(
            "my_rust_extension",
            sources=["src/lib.rs"],  # This is a placeholder.  PyO3 handles the actual build.
        ),
    ],
    # PyO3 setup
    setup_requires=['setuptools-rust>=0.11.4'],
    rust_extensions=[
        RustExtension("my_rust_extension", "Cargo.toml"),
    ],
    zip_safe=False,
)

登录后复制