PyCharm 2026.2 Help

安装插件

插件扩展 PyCharm 的核心功能。 例如,安装插件以获得以下功能:

  • 与版本控制系统、问题跟踪器、构建管理服务器等工具集成。

  • 针对多种语言和框架的代码辅助支持。

  • 快捷键提示、实时预览、 File Watchers 等。

  • 有助于学习新编程语言的编码练习。

打开插件设置

  • 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

插件设置,Marketplace 选项卡激活,显示精选:JetBrains AI Assistant、Spark、Kubernetes;Databricks 详情可见。

使用 插件市场 选项卡从 JetBrains Marketplace 或 自定义插件存储库 浏览并安装插件。

使用 已安装 选项卡浏览捆绑的和已安装的插件,并启用、禁用、更新或移除它们。 禁用不必要的插件可提升性能。

大多数插件可用于任何 JetBrains 产品。 部分仅限于商业产品,另一些需要单独的许可证。

如果某个插件依赖其他插件,您可以在 其他信息 选项卡中找到依赖项列表。 如果您的 项目 依赖某些插件,请将它们添加到 必需插件 列表中。

默认情况下,PyCharm 包含多个捆绑的插件。 您可以禁用捆绑的插件,但无法将其移除。 此外,您可以从插件存储库或本地归档文件(ZIP 或 JAR)安装其他插件。

从 JetBrains Marketplace 安装插件

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 点击 插件市场 选项卡,并在搜索字段中输入插件名称。

  3. 要安装该插件,点击 安装 ,并重启 PyCharm。

要安装特定版本,请转到该插件在 JetBrains Marketplace 上的页面,并按照 从磁盘安装插件 中的说明下载并安装它。 例如,当插件的最新版本存在问题时,您可以这样做。

从磁盘安装插件

  1. 下载插件归档文件(ZIP 或 JAR)。

  2. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  3. 在 插件 页面,点击 “设置”按钮 ,然后点击 从磁盘安装插件。

    插件设置页面,设置菜单已打开,显示“从磁盘安装插件”选项。
  4. 选择插件归档文件,然后点击 确定。

  5. 点击 确定 以应用更改,并在提示时重启 IDE。

通过命令行安装插件

  1. 退出您要安装插件的 IDE。

  2. 在 JetBrains Marketplace中,找到要安装的插件页面,向下滚动到 附加信息 部分,并从 插件 ID 参数复制其值,例如 org.jetbrains.plugins.github。

  3. 安装插件:

    导航到 PyCharm bin 目录下的 安装目录 ,并运行以下命令:

    pycharm64.exe installPlugins <PluginID>

    例如:

    pycharm64.exe installPlugins org.jetbrains.plugins.github

    运行以下命令:

    open -na "PyCharm.app" --args installPlugins <PluginID>

    例如:

    open -na "PyCharm.app" --args installPlugins org.jetbrains.plugins.github

    导航到 PyCharm bin 目录下的 安装目录 ,并运行以下命令:

    pycharm.sh installPlugins <PluginID>

    例如:

    pycharm.sh installPlugins org.jetbrains.plugins.github

有关更多信息,请参见 从命令行安装插件。

移除插件

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 打开 已安装 选项卡,找到您要移除的插件。

  3. 展开 禁用 列表,并选择 卸载。

    卸载插件

手动更新插件

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 如果已安装的插件有新版本,插件设置中会出现 更新 按钮。 点击该按钮以更新插件。

要配置 IDE 是否应检查更新,请打开 设置 Ctrl+Alt+S ,然后转到 外观&行为 | 系统设置 | 更新。 在此页面,您也可以点击 检查更新 手动检查插件存储库中的可用插件更新。

如果您希望 IDE 自动更新所有插件,您可以 进行相应配置。

有关 IDE 和插件更新的更多信息,请参阅 更新 PyCharm。

自动更新插件

默认情况下,当插件有新版本可用时,PyCharm 会通知您手动更新该插件。 您可以将 PyCharm 配置为自动下载插件更新,并在下次重启 IDE 时应用这些更新。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 点击 “设置”按钮 ,然后选择 自动更新插件。

    或者,转到 外观&行为 | 系统设置 | 更新 ,然后选择 自动更新插件。

禁用插件

如果您不需要相应功能,您可以在不移除插件的情况下将其禁用。

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 打开 已安装 选项卡,找到并选择您要禁用的插件。

  3. 在插件的描述窗格中,点击 禁用。

    或者,您可以使用插件列表中的复选框,或使用插件类别的 全部禁用 按钮。

您可以在 “设置”按钮 下的菜单中一次性禁用或启用所有手动安装的插件(非捆绑)。

禁用所有已下载的插件

必需的插件

项目可能需要提供对某些技术或框架支持的插件。 您可以将此类插件添加到当前项目的 必需插件 列表中,以便 PyCharm 将验证这些插件是否已安装并已启用。 如果您忘记某个插件,或者团队中的某人在处理项目时未意识到该依赖项,PyCharm 会通知您。

为当前项目添加必需插件

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 外观 & 行为 | 必需插件。

  2. 在 必需插件 页面,点击 Add 图标 ,然后选择该插件。 (可选)指定该插件的最低和最高版本。

    添加所需插件对话框

必需插件列表存储在项目的 .idea/externalDependencies.xml 文件中。 在 PyCharm 中打开 项目 时,如果必需插件被禁用、未安装或需要更新,PyCharm 将通知您。

所需插件已被禁用

点击通知消息中的链接,可快速启用、安装或更新所需插件。

建议的插件

当您打开 项目 时,PyCharm 可根据您的 项目 中使用的库建议安装并启用插件。 请勿将 建议的插件 与 必需插件 混淆;您可以将后者手动添加到 项目,以便您的队友也使用它。

如果您不需要某个插件,您可以阻止 PyCharm 建议它。 您还可以使用您的 通知设置 来禁用或启用所有插件建议的通知及其显示方式。

禁用某个插件的建议

  • 当出现建议插件的通知时,点击 不再建议。

下次打开 项目 时,PyCharm 将不再建议该插件。

检查项目中的建议插件

您可以检查项目中的建议插件,但对于您已 禁用建议的插件除外。

  1. 请按 Ctrl+Shift+A 并开始键入 Check Suggested Plugins。

  2. 选择 检查推荐的插件 操作。

    转到操作弹窗,突出显示“检查推荐插件”为首选项,GitLab、规则和软件包检查器位于下方。
  3. 如果 PyCharm 有适用于您的 项目 的插件,您将看到通知消息。 点击通知消息中的链接以安装或启用建议的插件。

或者,您可以打开 IDE 设置(Ctrl+Alt+S ),转到 插件 | Marketplace :如果您的项目有建议的插件,它们会显示在插件列表顶部的 建议 部分。

插件 Marketplace 选项卡,显示推荐部分,已安装并启用 dbt Support 插件。

自定义插件存储库

默认情况下,PyCharm 配置为使用来自 JetBrains Marketplace 的插件。 这是一个公共存储库,任何人都可以在其中托管其插件。 但是,如果您仅为内部使用开发插件,您可以为其设置自定义插件存储库。

有关设置自定义插件存储库的更多信息,请参阅 IntelliJ Platform SDK 文档。

设置好插件存储库后,将其添加到 PyCharm:

添加自定义存储库

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件。

  2. 在 插件 页面,点击 “设置”按钮 ,然后选择 管理插件存储库…。

    管理插件存储库菜单
  3. 在 自定义插件存储库 对话框中,点击 Add 图标 ,并指定您的存储库 URL。 它必须指向描述您插件的 XML 文件 的位置,例如 updatePlugins.xml 。 该文件可以与您的自定义插件位于同一服务器上,也可以位于专用服务器上。

    如何添加自定义插件存储库
  4. 在 自定义插件存储库 对话框中点击 确定 以保存插件存储库列表。

  5. 在 设置 对话框中点击 确定 以应用更改。

搜索插件时,PyCharm 将同时显示来自默认 JetBrains Marketplace 和您指定的任何自定义存储库的结果。 要仅浏览某个自定义插件存储库,请在 插件 页面 的 插件市场 选项卡的搜索字段中输入 repository: ,随后输入该存储库的 URL。 例如:

repository:http://plugins.example.com:8080/updatePlugins.xml myPlugin

或者,您可以使用 idea.plugin.hosts 属性添加自定义插件存储库:

  1. 转到 帮助 | 编辑自定义属性…。

  2. 将 idea.plugin.hosts 属性添加到平台属性文件,并指定描述您插件的 XML 文件 的 URL。 例如:

    idea.plugin.hosts="http://plugins.example.com:8080/updatePlugins.xml"
  3. 重启 PyCharm。

您可能希望将默认的 JetBrains Marketplace 替换为您的自定义插件存储库。 如果您希望 PyCharm 仅提供来自您的自定义存储库的插件,这将很有帮助。

替换默认插件存储库

  1. 转到 帮助 | 编辑自定义属性…。

  2. 将 idea.plugins.host 属性添加到平台属性文件,并指定能够正确处理来自 PyCharm 请求的应用程序的 URL,即作为默认插件存储库应用程序以替代 JetBrains Marketplace。

    特别是,它应处理以下请求:

  3. 重启 PyCharm。

如果您替换了默认插件存储库, 插件 对话框的 插件市场 选项卡上的搜索字段将仅浏览新默认存储库以及您添加的任何自定义存储库中的插件。

效率提示

筛选并排序搜索结果

  • 在搜索字符串中输入正斜杠 / 以查看用于筛选和排序搜索结果的选项。 例如,您可以在搜索字符串中添加以下选项,只列出与 AI 相关的插件,并按名称的字母顺序排序:

    /tag:AI /sortBy:name

一些与 IDE 集成的网站、文档页面和教程可能包含可以打开 IDE 并提示安装插件的链接。 点击安装链接时:

  1. IDE 将打开。

  2. IDE 会检查所请求的插件是否可用。

  3. 如果插件兼容,将会提示安装或启用。

  4. 安装完成后,插件即可使用。 如果需要重启,IDE 会提醒。

    如果链接中包含多个插件,可以一次性安装。

例如,可使用此链接 安装 Mercurial 插件。

2026年 7月 14日