文章导读

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

作者 2025年8月24日 17

在 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。

例如，使用 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, )

注意事项

确保你的 Rust 代码不依赖于特定于 Windows 的 API。
在 macOS 上测试编译后的扩展，以确保其正常工作。
如果遇到链接错误，请检查链接器配置和库依赖项。
使用虚拟环境来管理 Python 依赖项，避免与系统 Python 环境冲突。
确保 macOS 上的 Python 版本与你在 Windows 上开发时使用的 Python 版本兼容。

总结

通过交叉编译，你可以在 Windows 上开发和构建 Rust Python 扩展，使其能在 macOS 上运行，而无需直接使用 Mac 设备。这大大提高了开发效率，并降低了开发成本。关键在于配置正确的 Rust 工具链、目标平台和链接器，并确保代码的跨平台兼容性。

评论（已关闭）

评论已关闭

Hello! 欢迎来到悠悠畅享网！