【笔记】在 MSYS2（MINGW64）中安装 Python 工具链的记录

#工作记录

📌 安装背景

• 操作系统：MSYS2 MINGW64
• 当前时间：2025年6月1日
• Python 版本：3.12（默认通过 pacman 安装）
• 目标工具链：
  • pipx
  • numpy
  • pip
  • setuptools
  • wheel

---

🛠️ 安装过程与结果记录

1. 尝试安装 mingw-w64-x86_64-python-pipx —— ❌ 失败

pacman -S mingw-w64-x86_64-python-pipx

 

错误信息：

error: failed to commit transaction (conflicting files)
mingw-w64-x86_64-python-colorama: 文件已存在于文件系统中。

原因分析：

• colorama 库已经被 pip 安装过，而 pacman 安装时检测到冲突文件。
• MSYS2 的 pacman 和 pip 管理的包路径冲突。

解决建议：

• 使用 pip 安装 pipx（推荐）：

  pip install pipx

• 或强制覆盖安装（谨慎）：

  pacman -S mingw-w64-x86_64-python-pipx --force

---

2. 安装 mingw-w64-x86_64-python-numpy ✅ 成功（重新安装）

pacman -S mingw-w64-x86_64-python-numpy

 

• 版本：2.2.6-1
• 安装类型：Reinstall
• 安装大小：52.19 MiB
• 结果：成功

---

3. 安装 mingw-w64-x86_64-python-pip ✅ 成功（重新安装）

pacman -S mingw-w64-x86_64-python-pip

 

• 版本：25.1.1-1
• 安装类型：Reinstall
• 安装大小：13.63 MiB
• 结果：成功

---

4. 安装 mingw-w64-x86_64-python-setuptools ✅ 成功（重新安装）

pacman -S mingw-w64-x86_64-python-setuptools

 

• 版本：78.1.0-1
• 安装类型：Reinstall
• 安装大小：13.23 MiB
• 结果：成功

---

5. 安装 mingw-w64-x86_64-python-wheel ✅ 成功

pacman -S mingw-w64-x86_64-python-wheel

 

• 版本：0.45.1-1
• 下载大小：0.10 MiB
• 安装大小：0.36 MiB
• 结果：成功

---

🧾 总结

工具	是否成功	版本号	备注
pipx	❌ 失败	N/A	与 pip 安装的库冲突
numpy	✅ 成功	2.2.6-1	重新安装
pip	✅ 成功	25.1.1-1	重新安装
setuptools	✅ 成功	78.1.0-1	重新安装
wheel	✅ 成功	0.45.1-1	正常安装

---

💡 建议与后续操作

🔁 解决 pipx 安装失败的方法

1. 使用 pip 安装 pipx（推荐方式）

   pip install pipx
   pipx ensurepath

2. 设置环境变量（如提示找不到命令）

    

   添加 pipx 到 PATH：

   export PATH="$HOME/.local/bin:$PATH"

   可将该行写入 ~/.bashrc 中永久生效：

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc

3. 验证 pipx 是否可用

   pipx --version

---

📋 验证所有安装是否正常

你可以运行以下命令确认各组件是否正常工作：

python --version
pip --version
pipx --version
python -c "import numpy; print(numpy.__version__)"
python -c "import setuptools; print(setuptools.__version__)"
python -c "import wheel; print(wheel.__version__)"

---

📦 补充说明

• pacman vs pip：
  • pacman 是 MSYS2 的官方包管理器，适合安装系统级依赖。
  • pip 是 Python 的包管理器，更适合安装纯 Python 包。
  • 若发生文件冲突，建议优先用一种方式管理包，避免混用。

---

🧩 后续建议

如果你计划开发 Python 项目，可以考虑：

• 创建虚拟环境：

  python -m venv venv
  source venv/bin/activate

• 使用 pipx 安装 CLI 工具，如 black, ruff, poetry 等：

  pipx install black
  pipx install poetry

---