PyCharm 2025.2 Help

安装、卸载和升级软件包

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

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

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

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

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

Python Packages 工具窗口

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

安装软件包

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

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

    如果当前的 Python 解释器是 conda virtual environment ,则还会显示 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. 如果您想以可编辑模式安装软件包(例如,setuptools 的 开发模式 ),请选择 作为editable (-e)安装

从磁盘安装软件包

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

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

  3. 如果您想以可编辑模式安装软件包(例如,setuptools 的 开发模式 ),请选择 作为editable (-e)安装

升级包

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

    有可用的较新版本软件包

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

卸载软件包

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

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

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

要为项目的 Python 解释器管理 Python 软件包,请转到 设置 | 项目:<project_name> | Python 解释器 或在 Python Interpreter selector 中选择 解释器设置。 然后在 Python 解释器 字段中选择解释器。

查看已安装的 Python 软件包

安装软件包

  1. 点击工具栏上的 安装

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

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

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

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

    • 安装到用户的站点包目录 <path> :如果此复选框被禁用(默认情况下),软件包将安装到当前解释器的软件包目录中。 如果启用此复选框,软件包将安装到指定目录中。 此选项仅适用于 conda 环境。

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

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

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

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

    使用 Conda 软件包管理器

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

卸载软件包

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

  2. 请点击 卸载 工具栏。

    卸载 Python 软件包

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

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

显示包括测试版和候选版本在内的最新可用版本

升级包

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

  2. 请点击 升级 工具栏。

    升级 Python 软件包

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

  3. 点击 确定 完成升级。

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

重用已安装的软件包

最后修改日期: 2025年 9月 26日