软件包安装问题
软件包安装问题在项目设置或 Python Package 工具窗口中 安装 Python 软件包 时，您可能会遇到问题。 最终，大多数问题超出了 IDE 的控制范围，因为 PyCharm 使用 pip 包管理器 执行实际安装。
本文提供了故障排除提示并涵盖了一些典型案例。
使用终端安装软件包最可行的故障排除操作是尝试使用终端在所选 Python 解释器上安装有问题的软件包。 如果您收到相同的错误消息，则问题不在于 IDE，您应该 查看原因 和 典型案例 ，或者在互联网上搜索解决方案。
在虚拟环境中安装软件包按下 Ctrl+Alt+S 以打开设置，然后选择 项目
展开可用解释器列表并点击 显示全部。
找到目标解释器并复制虚拟环境的路径。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
.
pip install
source
pip install
检查并解析结果。
在 conda 环境中安装软件包如果您在配置解释器时未更改默认的 conda 环境名称，则可以使用项目名称。 否则，请执行以下操作：
按 Ctrl+Alt+S 并转到 项目：
展开项目解释器列表并向下滚动，然后选择 显示全部。
找到解释器，按 重命名 ，并复制环境名称。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
conda < 4.6
conda >= 4.6
activate
conda install
conda activate
conda install
conda < 4.6
conda >= 4.6
source activate
conda install
conda activate
conda install
有关激活环境的更多信息，请参阅 conda 文档。
可能的失败案例之一是目标软件包在 conda 包管理器支持的存储库中不可用。
检查并解析结果。
在系统解释器上安装软件包要检查您尝试安装软件包的当前选定系统解释器的路径，请按 Ctrl+Alt+S 并转到 项目：
展开可用解释器列表并点击 显示全部。
找到解释器并复制路径。
打开系统终端（不是 PyCharm 内置终端）并运行以下命令：
您可能需要管理员权限才能在系统解释器上安装软件包。
检查并解析结果。
解析结果结果
操作
无法安装该软件包，因为 Python 版本不满足软件包的要求。
尝试 创建另一个 Python 解释器 ，该解释器基于满足要求的 Python 版本。
无法安装该软件包，因为您没有安装它的权限。
尝试使用超级用户权限安装该软件包，例如， sudo pip install
无法安装该软件包，因为该软件包在所选包管理器支持的存储库中不可用。 示例：您尝试安装的软件包在 conda 包管理器的存储库中不可用。
尝试为您的项目配置另一种类型的 Python 解释器，并在其上安装该软件包。 请参阅 配置 Python 解释器 中关于添加和修改 Python 解释器的说明。
无法安装该软件包，并且它符合典型的 软件包安装失败案例 之一。
检查这些案例 并应用相关的解决方法。
软件包已成功安装。
在 PyCharm 问题跟踪器 中提交问题，并提供有关该案例的详细信息，包括所有控制台输出、错误消息和截图，表明您尝试在终端和项目设置或 Python 包 工具窗口中在同一解释器上安装该软件包。
查看典型案例错误消息
相关软件包
解决方法
参考
fatal error: 'SDL.h' file not found
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
Cannot open include file: 'portaudio.h'
pyaudio
尝试使用管理员权限运行以下命令：
pip install pipwin
pipwin install pyaudio
https://stackoverflow.com/questions/51992375/how-to-fix-installation-issues-for-pyaudio-portaudio-fatal-error-c1083-canno
https://www.programmersought.com/article/5816775591/
SSL module in Python is not available
任何软件包
通过特定于您的操作系统的方式安装 openssl 库。 请参阅 详细解决方案。
https://stackoverflow.com/questions/41328451/ssl-module-in-python-is-not-available-when-installing-package-with-pip3/54932141#54932141。
最后修改日期： 2025年 9月 26日文件类型问题发送反馈