PyCharm 2025.3 Help

安装、卸载和升级软件包

PyCharm 为特定的 Python 解释器提供用于安装、卸载和升级 Python 软件包的方法。 这意味着每个项目都有自己的一组软件包,这被认为是 Python 依赖管理的最佳实践。 默认情况下,PyCharm 使用 pip 来管理项目的软件包。 对于 conda 环境,您可以使用 conda 包管理器

在 PyCharm 中,您可以在 Python 包 工具窗口以及 Python 解释器设置中预览和管理软件包。

在 Python Packages 工具窗口中管理软件包

Python 包 工具窗口为当前选定的 Python 解释器提供了最快捷、最简洁的预览和安装软件包的方式。 此工具窗口默认启用,您可以点击左侧的 Python 包 打开它。 您也可以随时通过主菜单打开它: 视图 | 工具窗口 | Python 包

Python 包 工具窗口显示已安装的软件包,以及 PyPI 和 conda 软件包存储库中可用的软件包。 使用搜索字段筛选可用软件包列表。

Python Packages 工具窗口

您可以在文档区域预览软件包文档,或点击 文档 链接在浏览器中打开。

安装软件包

  1. Python 包 工具窗口的搜索字段中开始键入软件包名称。 将显示匹配的软件包。

    在 Python Packages 工具窗口中搜索软件包

    如果当前 Python 解释器是 conda 虚拟环境 ,还会显示 conda 软件包存储库中可用的软件包。

  2. 选择该软件包,然后执行以下操作:

    • 点击软件包名称旁的 安装 并选择版本。

      从搜索结果中安装软件包
    • 从可用版本列表中选择版本,然后点击 安装

      选择要安装的软件包版本

    在安装过程中,您可以使用 pip install 命令行选项

    • 在软件包名称旁边右键点击,并选择 使用选项安装

    • 在打开的对话框中,输入所需的选项,然后点击 确定

    通过 condapip 安装的软件包会标注相应的图标。

    通过 conda 或 pip 安装的软件包
  3. 如果弹出带有错误消息的窗口,请参阅 故障排除指南 以获取解决方案。

管理软件包存储库

  1. 要指定自定义存储库(例如 devpi 或私有 PyPi 服务器),请点击搜索字段旁的 设置

  2. Python 包存储库 对话框中,点击 添加。 如果不需要授权,例如本地存储库,输入存储库 URL,然后点击 确定

    添加 Python 软件包存储库:无需授权
  3. 如果要从需要 HTTP 授权的存储库安装 Python 软件包,请点击 基本 HTTP ,并输入存储库 URL 和登录凭据。 点击 确定 完成任务。

    添加 Python 软件包存储库:基本 HTTP 授权

从版本控制系统安装软件包

  1. Python 包 工具栏上点击 添加包 链接,并选择 从版本控制

  2. 指定目标 git 存储库的路径。 有关支持的路径格式的更多信息,请参阅 pip 文档

    从版本控制安装
  3. 如果要以可编辑模式安装软件包,请选择 作为editable (-e)安装 (例如, setuptools develop mode)。

从磁盘安装软件包

  1. Python 包 工具栏上点击 添加包 链接,并选择 从磁盘

    从磁盘安装软件包
  2. 指定软件包目录或归档的路径( zip whl )。

  3. 如果要以可编辑模式安装软件包,请选择 作为editable (-e)安装 (例如, setuptools develop mode)。

升级软件包

  • 如果该软件包有较新版本可用,在软件包名称旁会显示一个包含当前版本和最新版本的链接。 点击该链接将软件包升级到最新版本。

    该软件包有可用的新版本

    如果弹出带有错误消息的窗口,请参阅 故障排除指南 以获取解决方案。

卸载软件包

  • 要删除已安装的软件包,请点击软件包版本旁的 卸载

    在 Python Packages 工具窗口中卸载软件包

在 Python 解释器设置中管理软件包

要为项目的 Python 解释器管理 Python 软件包,请前往 设置 | Python | 解释器 ,或在 Python Interpreter 选择器 中选择 解释器设置。 然后在 Python 解释器 字段中选择解释器。

查看已安装的 Python 软件包

安装软件包

  1. 点击工具栏上的 安装

    添加软件包
  2. 在打开的 可用软件包 对话框中,在搜索字段中键入软件包名称。

    显示可用的软件包
  3. 如有需要,选择以下复选框:

    • 指定版本 :选中此复选框后,您可以在列表中选择所需版本。 默认情况下,将安装最新版本。

    • 选项 :选中此复选框后,您可以在文本字段中键入 pip install 命令行选项

    • 安装到用户的 site-packages 目录 <path> :如果此复选框处于禁用状态(默认),软件包将安装到当前解释器的软件包目录中。 如果启用该复选框,软件包将安装到上述目录中。 此选项仅适用于 conda 环境。

  4. 选择该软件包并点击 安装包

  5. 如果弹出带有错误消息的窗口,请参阅 故障排除指南 以获取解决方案。

从 conda 软件包存储库安装软件包

  • 如果您选择了已配置 conda 环境的 Python 解释器,软件包区域的工具栏中会显示 使用 Conda 包管理器 切换开关。

    使用 conda 包管理器

    使用此切换开关从 conda 软件包存储库安装和升级软件包。 对于 conda 环境,此切换开关默认启用。

卸载软件包

  1. 在软件包列表中,选择要卸载的软件包。

  2. 点击工具栏上的 卸载

    卸载 Python 软件包

PyCharm 通过显示当前已安装的软件包版本(列 版本 )和最新可用版本(列 最新版本 )来跟踪软件包状态并识别过时的版本。 检测到软件包有较新版本时,PyCharm 会用 有可用的新版本升级 图标标记它。

默认情况下, 最新版本 列仅显示软件包的稳定版本。 如果您想将最新可用版本的范围扩展到任何预发布版本(例如 beta候选版本 ),请点击 显示预发布版本

显示包含 beta 和候选版本在内的最新可用版本

升级软件包

  1. 在软件包列表中,选择要升级的软件包。

  2. 点击工具栏上的 升级

    升级 Python 软件包

    所选软件包将升级到最新可用版本。

  3. 点击 确定 完成升级。

如果您习惯于 从命令行安装软件包 ,您可以继续使用 Terminal 开展工作流程。

复用已安装的软件包

  • 创建新的虚拟环境 ,并安装您希望在其他项目中使用的软件包。 然后,您可以 指定此虚拟环境 为目标项目的 Python 解释器,所有所需的软件包都将可用。

  • 终端窗口 中执行以下命令:

    pip freeze > requirements.txt

    然后将创建的 requirements.txt 文件添加到目标项目中,PyCharm 会提示您 安装文件中列出的软件包

最后修改日期: 2025年 12月 2日