pip 和 poetry 安装 PyQt5 差异：问题和解决方案

如何解决 pip 和 poetry 在 PyQt5 安装上的差异

问题

在使用 poetry 安装 PyQt5 时，可能会遇到版本不兼容的问题，而 pip 安装却不会出现此问题。这是因为 poetry 采用了一种不同的安装方式，导致了这个问题。

原因分析

• pip 安装： pip 使用预构建的二进制包来安装 PyQt5，避免了构建过程。
• poetry 安装： poetry 尝试从源代码构建 PyQt5，但某些版本（如 5.15.11 和 5.15.2）与构建系统存在兼容性问题。

解决方法

要解决这个问题，需要禁用 poetry 的构建系统并使用预构建的二进制包。以下是如何操作：

1. 指定 PyQt5 版本

在 pyproject.toml 文件中，明确指定与构建系统兼容的 PyQt5 版本。例如：

[tool.poetry.dependencies]
pyqt5 = "5.15.10"

2. 禁用构建系统

在 pyproject.toml 文件中，在 [tool.poetry.build] 部分下添加以下行：

build-backend = "poetry.masonry.api"

这将禁用构建系统，并强制 poetry 使用预构建的二进制包。

3. 更新 poetry

运行 poetry update 命令来更新软件包依赖项，以反映更改后的 pyproject.toml 文件。

示例 pyproject.toml

[tool.poetry.dependencies]
python = "^3.11"
loguru = "^0.7.2"
sip = "^6.7.12"
pyqt5-sip = "^12.13.0"
pyqt5 = "5.15.10"

[tool.poetry.build]
build-backend = "poetry.masonry.api"

验证

完成这些步骤后，再次运行 poetry update 命令。如果成功，它将安装 PyQt5 而不会遇到错误。

附加说明

• 指定的 PyQt5 版本（5.15.10）已知与构建系统兼容。
• 其他版本的 PyQt5 可能也兼容，但建议使用经过测试的版本以避免潜在问题。
• 如果问题仍然存在，请确保您的 Python 环境和 poetry 是最新的，并且没有其他底层问题影响安装过程。

常见问题解答

1. 为什么 poetry 使用构建系统来安装 PyQt5？

为了提高跨平台兼容性和灵活性。构建系统允许 poetry 为不同平台构建 PyQt5，而不是依赖于特定平台上的预构建包。

2. 是否可以完全禁用 poetry 的构建系统？

可以，通过在 pyproject.toml 文件中将 build-backend 设置为 null。但是，这可能会导致与其他依赖项的兼容性问题。

3. 如何确定哪个 PyQt5 版本与构建系统兼容？

通过查看 Poetry 文档或 PyQt5 发行说明来确定受支持的版本。

4. 如果我遇到其他安装问题怎么办？

请检查 poetry 文档或社区论坛以寻求帮助。

5. pip 和 poetry 之间还有什么区别？

• 依赖项管理： poetry 提供了更高级的依赖项管理功能，例如依赖项树和冲突解决。
• 虚拟环境： poetry 可以自动创建和管理虚拟环境，而 pip 则需要手动创建。
• 构建系统： poetry 可以使用构建系统来编译和安装软件包，而 pip 通常依赖于预构建的二进制包。