软件包安装问题
在项目设置或 Python Package 工具窗口中 安装 Python 软件包 时，您可能会遇到问题。 最终，大多数问题超出了 IDE 的控制范围，因为 PyCharm 使用 pip 包管理器 执行实际安装。
本文提供了故障排除提示并涵盖了一些典型案例。
使用终端安装软件包
最可行的故障排除操作是尝试使用终端在所选 Python 解释器上安装有问题的软件包。 如果您收到相同的错误消息，则问题不在于 IDE，您应该 查看原因 和 典型案例 ，或者在互联网上搜索解决方案。
在虚拟环境中安装软件包
按下 Ctrl+Alt+S 以打开设置，然后选择 。
展开可用解释器列表并点击 显示全部。
找到目标解释器并复制虚拟环境的路径。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
. <venv path>/bin/activate pip install <package name>
source <venv path>/bin/activate pip install <package name>
在 conda 环境中安装软件包
如果您在配置解释器时未更改默认的 conda 环境名称，则可以使用项目名称。 否则，请执行以下操作：
按 Ctrl+Alt+S 并转到 。
展开项目解释器列表并向下滚动，然后选择 显示全部。
找到解释器，按
重命名 ，并复制环境名称。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
conda < 4.6
conda >= 4.6
activate <conda env name> conda install <package name>conda activate <conda env name> conda install <package name>conda < 4.6
conda >= 4.6
source activate <conda env name> conda install <package name>conda activate <conda env name> conda install <package name>有关激活环境的更多信息，请参阅 conda 文档。
可能的失败案例之一是目标软件包在 conda 包管理器支持的存储库中不可用。
在系统解释器上安装软件包
要检查您尝试安装软件包的当前选定系统解释器的路径，请按 Ctrl+Alt+S 并转到 。
展开可用解释器列表并点击 显示全部。
找到解释器并复制路径。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
<interpreter path> -m pip install <package name>
您可能需要管理员权限才能在系统解释器上安装软件包。
解析结果
结果 | 操作 |
|---|---|
无法安装该软件包，因为 Python 版本不满足软件包的要求。 | 尝试 创建另一个 Python 解释器 ，该解释器基于满足要求的 Python 版本。 |
无法安装该软件包，因为您没有安装它的权限。 | 尝试使用超级用户权限安装该软件包，例如， |
无法安装该软件包，因为该软件包在所选包管理器支持的存储库中不可用。 示例：您尝试安装的软件包在 conda 包管理器的存储库中不可用。 | 尝试为您的项目配置另一种类型的 Python 解释器，并在其上安装该软件包。 请参阅 配置 Python 解释器 中关于添加和修改 Python 解释器的说明。 |
无法安装该软件包，并且它符合典型的 软件包安装失败案例 之一。 | 检查这些案例 并应用相关的解决方法。 |
软件包已成功安装。 | 在 PyCharm 问题跟踪器 中提交问题，并提供有关该案例的详细信息，包括所有控制台输出、错误消息和截图，表明您尝试在终端和项目设置或 Python 包 工具窗口中在同一解释器上安装该软件包。 |
查看典型案例
错误消息 | 相关软件包 | 解决方法 | 参考 |
|---|---|---|---|
| pygame, pysc2 | 安装失败，因为该软件包需要 SDL，而 pip 无法检测到它。 尝试以下命令：
brew install sdl sdl_image sdl_mixer sdl_ttf portmidi;
pip3 install pygame;
pip install pygame
| https://stackoverflow.com/questions/45992243/pip-install-pygame-sdl-h-file-not-found |
| pyaudio | 尝试使用管理员权限运行以下命令：
pip install pipwin
pipwin install pyaudio
| |
| 任何软件包 | 通过特定于您的操作系统的方式安装 openssl 库。 请参阅 详细解决方案。 |