解决 Windows 7 上 rtmidi Python 库安装失败的问题

本文旨在帮助解决在 Windows 7 系统上使用 Python 3.8 安装 rtmidi 库时遇到的 "Microsoft Visual C++ 14.0 or greater is required" 错误。文章将分析错误原因，并提供升级 Python 版本至 3.11 的解决方案，确保 rtmidi 库能够成功安装。

在 Windows 7 上尝试安装 rtmidi Python 库时，可能会遇到类似以下的错误信息：

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/

这通常意味着系统缺少编译 rtmidi 库所需的 C++ 编译器。虽然尝试安装 C++ Redistributable 或升级 pip 可能有效，但根本原因在于 rtmidi 的版本兼容性。

解决方案：升级 Python 版本

根据 rtmidi 的官方文档，该库当前支持 Python 3.11。 因此，最直接有效的解决方案是将 Python 版本升级到 3.11。

步骤：

1. 卸载旧版本 Python (可选): 如果你已安装 Python 3.8，可以先将其卸载，以避免版本冲突。

2. 下载 Python 3.11: 访问 Python 官方网站 (https://www./link/598e989a5706e1ab5cea5e65598d2125)，下载适用于 Windows 的 Python 3.11 安装包。请务必选择与你的操作系统架构相匹配的版本 (32 位或 64 位)。

3. 安装 Python 3.11: 运行下载的安装包。在安装过程中，请务必勾选 "Add Python to PATH" 选项，这将方便你在命令行中使用 python 和 pip 命令。

4. 验证安装: 打开命令提示符或 PowerShell，输入 python --version。如果显示 "Python 3.11.x"，则表示安装成功。

5. 安装 rtmidi: 在命令提示符或 PowerShell 中，使用以下命令安装 rtmidi 库：

   python -m pip install rtmidi

   python -m pip 确保你使用的是与 Python 3.11 关联的 pip。

注意事项：

• 环境变量: 确保 Python 3.11 的安装路径已添加到系统的 PATH 环境变量中。这通常在安装过程中自动完成，但如果遇到问题，可能需要手动添加。

• 依赖项: 安装 rtmidi 可能会自动安装一些依赖项。请确保你的网络连接正常，以便顺利下载这些依赖项。

• 虚拟环境 (推荐): 为了隔离不同项目的依赖项，建议使用虚拟环境。可以使用 venv 模块创建虚拟环境：

  python -m venv myenv
  myenv\Scripts\activate  # 激活虚拟环境 (Windows)
  source myenv/bin/activate #激活虚拟环境 (macOS/Linux)
  pip install rtmidi

总结：

通过将 Python 版本升级到 3.11，可以解决在 Windows 7 上安装 rtmidi 库时遇到的 C++ 编译器错误。 升级 Python 版本不仅能解决 rtmidi 的安装问题，还能让你使用 Python 的最新功能和改进。 使用虚拟环境能更好的管理项目依赖，避免不同项目之间的冲突。