常见问题

在项目设置或Python 包工具窗口中安装 Python 包时,您可能会遇到问题。最终,大多数问题都超出了 IDE 的控制,因为 PyCharm 使用pip 包管理器来执行实际安装。

本文提供故障排除技巧并涵盖一些典型案例。

使用终端安装包

最可行的故障排除措施是尝试使用终端在选定的 Python 解释器上安装有问题的包。如果您收到相同的错误消息,则问题不在 IDE 中,您应该查看基本原理典型案例,或在 Internet 上搜索解决方案。

在虚拟环境中安装包

  1. 要检查您尝试在其上安装包的当前选定 Python 解释器的路径,请按Ctrl+Alt+S并转到项目:<项目名称> | Python 解释器

  2. 展开项目解释器列表并向下滚动,然后选择Show All项。

    选定的虚拟环境
  3. 找到目标解释器并按编辑解释器

    发现所选 venv 的解释器路径

    复制或记住虚拟环境的路径并关闭对话框。

  4. 打开终端并运行以下命令:

    source <venv 路径>/bin/activate pip install <包名>
    在虚拟环境中安装 Python 包
  5. 检查并解析结果

在 Conda 环境中安装包

  1. 打开终端并运行以下命令:

    康达 < 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 文档。

    在虚拟环境中安装 Python 包

    当目标包在 Conda 包管理器支持的存储库中不可用时,会发生一种可能的故障情况。

    在 Conda 环境中安装包失败
  2. 检查并解析结果

在系统解释器上安装包

  1. 要检查您尝试在其上安装软件包的当前选定系统解释器的路径,请按Ctrl+Alt+S并转到项目:<项目名称> | Python 解释器

  2. 展开项目解释器列表并向下滚动,然后选择Show All项。

    选定的 Python 解释器
  3. 找到翻译并按编辑解释器

    发现所选 venv 的解释器路径

    复制或记住环境的路径并关闭对话框。

  4. 打开终端并运行以下命令:

    cd <解释器路径> -m pip install <包名>
    在系统环境中安装 Python 包

    您可能需要管理员权限才能在系统解释器上安装软件包。

  5. 检查并解析结果

解析结果

结果

行动

无法安装包,因为 Python 版本不满足包要求。

尝试创建另一个基于满足要求的 Python 版本的 Python 解释器。

无法安装该软件包,因为您没有安装它的权限。

尝试使用超级用户权限安装软件包,例如sudo pip install <package name>.

无法安装该包,因为该包在所选包管理器支持的存储库中不可用。示例:您正在尝试安装在 Conda 包管理器存储库中不可用的包。

尝试为您的项目配置另一种类型的 Python 解释器并在其上安装包。在配置 Python 解释器中查看如何添加和修改 Python 解释器。

无法安装该软件包,它与典型的软件包安装失败案例之一相匹配。

检查案例并应用相关的解决方法。

该软件包已成功安装。

PyCharm 问题跟踪器中提交问题并提供有关该案例的明确详细信息,包括所有控制台输出、错误消息和屏幕截图,表明您尝试在终端和项目设置或Python 包中的同一解释器上安装包工具窗口。

回顾典型案例

错误信息

相关包

解决方法

参考

fatal error: 'SDL.h' file not found

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

Cannot open include file: 'portaudio.h'

音频

尝试使用管理员权限运行以下命令:

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

最后修改:2021 年 9 月 14 日