包安装问题
在项目设置或Python 包工具窗口中安装 Python 包时，您可能会遇到问题。最终，大多数问题都超出了 IDE 的控制，因为 PyCharm 使用pip 包管理器来执行实际安装。
本文提供故障排除技巧并涵盖一些典型案例。
使用终端安装包
最可行的故障排除措施是尝试使用终端在选定的 Python 解释器上安装有问题的包。如果您收到相同的错误消息，则问题不在 IDE 中，您应该查看基本原理和典型案例，或在 Internet 上搜索解决方案。
在虚拟环境中安装包
要检查您尝试在其上安装包的当前选定 Python 解释器的路径，请按Ctrl+Alt+S并转到。
展开项目解释器列表并向下滚动，然后选择项。
找到目标解释器并按
。
复制或记住虚拟环境的路径并关闭对话框。
打开终端并运行以下命令：
source <venv 路径>/bin/activate pip install <包名>
在 Conda 环境中安装包
打开终端并运行以下命令：
康达 < 4.6
康达 >= 4.6
激活 <conda env name> conda install <package name>conda activate <conda 环境名称> conda install <软件包名称>康达 < 4.6
康达 >= 4.6
source activate <conda env name> conda install <package name>conda activate <conda 环境名称> conda install <软件包名称>有关如何激活环境的更多信息，请参阅Conda 文档。
当目标包在 Conda 包管理器支持的存储库中不可用时，会发生一种可能的故障情况。
在系统解释器上安装包
要检查您尝试在其上安装软件包的当前选定系统解释器的路径，请按Ctrl+Alt+S并转到。
展开项目解释器列表并向下滚动，然后选择项。
找到翻译并按
。
复制或记住环境的路径并关闭对话框。
打开终端并运行以下命令：
cd <解释器路径> -m pip install <包名>
您可能需要管理员权限才能在系统解释器上安装软件包。
解析结果
结果 | 行动 |
|---|---|
无法安装包，因为 Python 版本不满足包要求。 | 尝试创建另一个基于满足要求的 Python 版本的 Python 解释器。 |
无法安装该软件包，因为您没有安装它的权限。 | 尝试使用超级用户权限安装软件包，例如 |
无法安装该包，因为该包在所选包管理器支持的存储库中不可用。示例：您正在尝试安装在 Conda 包管理器存储库中不可用的包。 | 尝试为您的项目配置另一种类型的 Python 解释器并在其上安装包。在配置 Python 解释器中查看如何添加和修改 Python 解释器。 |
无法安装该软件包，它与典型的软件包安装失败案例之一相匹配。 | 检查案例并应用相关的解决方法。 |
该软件包已成功安装。 | 在PyCharm 问题跟踪器中提交问题并提供有关该案例的明确详细信息，包括所有控制台输出、错误消息和屏幕截图，表明您尝试在终端和项目设置或Python 包中的同一解释器上安装包工具窗口。 |
回顾典型案例
错误信息 | 相关包 | 解决方法 | 参考 |
|---|---|---|---|
| pygame，pysc2 | 安装失败，因为该包需要 SDL，而 pip 无法检测到它。尝试以下命令：
酿造安装 sdl sdl_image sdl_mixer sdl_ttf portmidi; pip3 安装 pygame；点安装 pygame
| https://stackoverflow.com/questions/45992243/pip-install-pygame-sdl-h-file-not-found |
| 音频 | 尝试使用管理员权限运行以下命令：
pip install pipwin pipwin install pyaudio
| |
| 任何包裹 | 通过特定于您的操作系统的方式安装 openssl 库。查看详细的解决方案。 |