【笔记】在 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 开发支持

---