【笔记】在 MSYS2(MINGW64)中安装 python-maturin 的记录
#工作记录
📌 安装背景
- 操作系统:MSYS2 MINGW64
- 当前时间:2025年6月1日
- Python 版本:3.12(通过 pacman 安装)
- 目标工具:
maturin
—— 用于构建和发布 Rust 编写的 Python 包
🛠️ 安装命令
pacman -S mingw-w64-x86_64-python-maturin
📦 安装详情
项目 | 内容 |
---|---|
包名 | mingw-w64-x86_64-python-maturin |
版本号 | 1.8.6-1 |
下载大小 | 8.58 MiB |
安装大小 | 35.14 MiB |
是否成功 | ✅ 成功 |
依赖解析 | 自动完成,无冲突 |
🧪 验证安装
查看 maturin 版本:
maturin --version
输出示例:
maturin 1.8.6
查看帮助信息:
maturin --help
确认命令正常执行,说明安装成功。
📋 简介:什么是 Maturin?
Maturin 是一个用于构建和发布 Python 包的工具,特别适用于使用 Rust 编写的 Python 扩展模块。它简化了将 Rust 代码编译为 Python 可用的 .whl
包的过程。
主要功能包括:
- 构建
wheel
包 - 支持
pyproject.toml
- 支持交叉编译
- 支持上传到 PyPI 或私有仓库
🚀 使用示例
如果你有一个使用 Rust 编写的 Python 包(如使用 pyo3
),可以使用以下命令快速构建:
cd your-rust-python-project/
maturin build
你也可以直接安装开发版本到当前环境中:
maturin develop
💡 小贴士
-
如果你在使用过程中遇到
command not found
错误,请确保你的环境变量 PATH 包含 Python 的脚本目录。 -
推荐配合
venv
使用,避免全局污染:python -m venv venv source venv/bin/activate
📝 总结
工具 | 是否成功 | 版本号 | 备注 |
---|---|---|---|
maturin | ✅ 成功 | 1.8.6 | 通过 pacman 安装,集成 Rust 和 Python 开发支持 |