PhpStorm 2026.3 Help

插件

插件扩展 PhpStorm 的核心功能。 例如，安装插件可以将 IDE 与版本控制系统、问题跟踪器、构建管理服务器集成，为各种语言和框架获得编码辅助支持，等等。

安装插件

默认情况下，PhpStorm 包含作为 IDE 安装的一部分随附的捆绑插件。 可以从 JetBrains Marketplace 或本地归档文件（ZIP 或 JAR）安装其他插件。 这些其他插件称为非捆绑插件或已下载插件。

从 Marketplace 安装插件

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 在搜索字段中键入要安装的插件名称。

    在搜索字段中点击 显示 Marketplace 结果 ，以查看用于对搜索结果排序的选项。 点击 筛选插件 查看可用的筛选器选项。

  3. 若要安装插件，请点击 安装 ，并在提示时重新启动 IDE。

    在 IDE 设置的插件页面安装插件

要安装特定版本，请访问 JetBrains Marketplace 的插件页面，按照 从磁盘安装插件 中的说明下载并安装。 例如，如果插件的最新版本损坏了，您可以这样做。

打开插件设置

  • 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

在这里可以找到多个插件类别：

  • 已安装 ：从 JetBrains Marketplace、自定义插件仓库或本地归档安装的其他插件。

  • 捆绑 ：PhpStorm 默认包含的插件。 可以启用或禁用其中大多数，但无法卸载它们。

  • 建议 ：PhpStorm 根据当前项目中检测到的技术 推荐的插件。

  • 插件市场 ：可从 JetBrains Marketplace 安装的插件。 查找插件时，这些插件会显示为搜索结果。

  • 如果使用了 自定义仓库 ，则为来自该仓库的插件。

插件设置显示插件列表；右侧显示 AI Agent 扩展程序详细信息

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

从磁盘安装插件

如果需要已从 JetBrains Marketplace 下载的特定插件版本，或第三方提供的插件，可以从磁盘安装插件。 在这种情况下，将从本地 ZIP 或 JAR 归档安装插件。

  1. 下载插件存档（ZIP 或 JAR）。

  2. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  3. 在 插件 页面上，点击 “设置”按钮管理仓库、配置代理或从磁盘安装插件 ，然后点击 从磁盘安装插件。

    插件设置页面，设置菜单已打开，并显示 "从磁盘安装插件" 选项。

  4. 请选择插件归档文件并点击 确定。

  5. 点击 确定 以应用更改，如有提示，请重启 IDE。

从命令行安装插件

如果想要自动化 IDE 设置，或在不使用图形接口的情况下安装插件，请从命令行安装插件。

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

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

  3. 安装插件：

    转到 PhpStorm 安装目录下的 bin 目录，并运行以下命令：

    phpstorm64.exe installPlugins <PluginID>

    例如：

    phpstorm64.exe installPlugins org.jetbrains.plugins.github

    请运行以下命令：

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

    例如：

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

    转到 PhpStorm 安装目录下的 bin 目录，并运行以下命令：

    phpstorm.sh installPlugins <PluginID>

    例如：

    phpstorm.sh installPlugins org.jetbrains.plugins.github

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

更新插件

手动更新插件

插件更新适用于具有 已配置更新源的插件。

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 如果已安装插件的新版本可用，插件设置中会出现 更新 按钮。 点击它以更新插件。

    插件设置中已选择 Kafka 插件；可用于较新版本的更新按钮可见。

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

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

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

自动更新插件

默认情况下，当插件的新版本可用时，PhpStorm 会通知您手动更新插件。 您可以配置 PhpStorm 自动下载插件更新，并在下次 IDE 重启时应用它们。

自动插件更新适用于具有 已配置更新源的插件。 在这种情况下，PhpStorm 会在指定仓库中检查更新，而不会自动安装来自其他仓库的更新。

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 点击 “设置”按钮管理仓库、配置代理或从磁盘安装插件 并选择 自动更新插件。

    设置对话框的插件页面，齿轮图标菜单已打开，其中"自动更新插件"选项已勾选并高亮显示。

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

插件更新源

PhpStorm 仅在插件来源已知时更新插件。 从 JetBrains Marketplace 或自定义插件仓库安装插件时，PhpStorm 会将该仓库记录为插件来源。

如果插件未配置更新源，PhpStorm 不会自动更新该插件，也不会在有可用更新时通知。 例如，从磁盘安装插件，或 IDE 无法确定之前安装的插件来源时，可能会发生这种情况。

如果 PhpStorm 停止更新某个插件，将看到一条通知，其中包含用于设置来源的链接。 否则，可以在设置中检查来源。

检查或更改插件更新源

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 选择已安装的插件并打开 其他信息 选项卡。

  3. 找到 更新来自 字段以查看或更改插件更新源。

    选择信任且希望从中接收该插件更新的仓库。

停用插件

禁用插件

如果不需要相应功能，但不想从 IDE 中卸载插件，可以禁用插件而不移除它。

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 查找并选择要禁用的插件。

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

    或者，可以使用插件列表中的切换按钮，或插件类别的 全部禁用 按钮。

可以在 “设置”按钮管理仓库、配置代理或从磁盘安装插件 下的菜单中一次性禁用或启用所有非捆绑插件。

禁用所有已下载的插件

卸载插件

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 查找并选择要卸载的插件。

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

    在 IDE 设置中卸载插件

所需插件

一个项目可能需要一些插件来提供对某些技术或框架的支持。 您可以将此类插件添加到当前项目的 required plugins列表中，这样 PhpStorm 就会验证这些插件是否已安装并启用。 如果您忘记了一些插件，或者团队中的某个人在处理项目时无意识地忽略了这些依赖项，它会通知您。

为当前项目添加所需插件

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

  2. 在 所需插件 页面上，点击 "添加"图标添加 并选择插件。 您可以选择性地指定插件的最低和最高版本。

    添加所需插件对话框

必需插件的列表存储在您项目的 .idea/externalDependencies.xml 文件中。 当您在 PhpStorm 中打开 项目 时，它会通知您是否必需插件已禁用、未安装或需要更新。

未安装所需插件警告

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

推荐的插件

当您打开一个 项目 时，PhpStorm 可以根据 项目 中使用的库建议安装和启用插件。 请勿将 推荐插件与 必需插件混淆，您可以手动将其添加到 项目 中，以便您的团队成员也使用它。

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

禁用插件推荐

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

下次您打开 项目 时，PhpStorm 将不会建议此插件。

检查项目的推荐插件

您可以检查您的项目建议插件，除了您已经 禁用建议的插件。

  1. 按 Ctrl+Shift+A 并开始键入 检查建议的插件。

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

    Go to Action 弹出窗口，显示检查建议的插件操作在操作选项卡下作为最靠前的结果高亮显示。

  3. 如果 PhpStorm 有适用于 项目 的插件，将会看到一条通知消息。 点击通知消息中的链接以安装或启用建议的插件。

或者，可以打开 IDE 设置（Ctrl+Alt+S ）并选择 插件 ：如果有针对项目建议的插件，它们将显示在 建议 部分中。

插件设置显示插件列表；右侧显示 AI Agent 扩展程序详细信息

自定义插件存储库

默认情况下，PhpStorm 配置为使用 JetBrains Marketplace 中的插件。 这是一个公开的代码库，任何人都可以在这里托管他们的插件。 然而，如果您仅为内部使用开发插件，您可以为其设置一个自定义插件库。

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

设置好插件存储库后，将其添加到 PhpStorm：

添加自定义存储库

  1. 打开设置 ，或在 IDE 中按 Ctrl+Alt+S ，然后选择 插件。

  2. 在 插件 页面上，点击 “设置”按钮管理仓库、配置代理或从磁盘安装插件。

    管理插件存储库菜单

  3. 在 自定义插件仓库 对话框中，点击 "添加"图标添加 并指定仓库 URL。

    URL 需要指向 描述您的插件的 XML 文件的位置，例如 updatePlugins.xml 。 文件可以与 您的自定义插件 位于同一服务器上，也可以位于专用服务器上。

    添加自定义插件存储库

  4. 请点击 确定 在 自定义插件仓库 对话框中以保存插件存储库列表。

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

当您搜索插件时，PhpStorm 将为您显示来自默认的 JetBrains Marketplace 和您指定的任何自定义存储库的结果。 若只浏览某个自定义插件仓库，请点击 筛选插件筛选插件 ，选择 存储库 ，然后从列表中选择此仓库。

或者，您可以使用 idea.plugin.hosts 属性添加自定义插件仓库：

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

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

    idea.plugin.hosts="http://plugins.example.com:8080/updatePlugins.xml"

  3. 重启 PhpStorm。

您可能希望将默认的 JetBrains Marketplace 替换为您自定义的插件存储库。 如果您只希望自定义库插件在 PhpStorm 中可用，这会很有帮助。

替换默认插件存储库

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

  2. 将 idea.plugins.host 属性添加到平台属性文件中，并指定可以正确处理来自 PhpStorm 请求的应用程序的 URL，即作为默认插件库应用程序而不是 JetBrains Marketplace。

    特别是，它应处理以下请求：

  3. 重启 PhpStorm。

如果替换默认插件仓库， 插件 对话框的搜索字段将仅浏览新的默认仓库以及添加的任何自定义仓库中的插件。

手动配置插件更新源

机构可以直接在 IDE 插件目录中安装或更新插件。 由于这会绕过标准安装流程，PhpStorm 可能不知道应在哪里检查更新。 用户可能会看到关于缺少更新源的警告，并且这些插件不会自动更新。

管理员可以通过编辑 pluginUpdateSources.xml 文件来配置插件更新源。

  1. 找到并打开 PhpStorm 配置目录。

  2. 打开 options 文件夹。

  3. 打开或创建 pluginUpdateSources.xml 文件。

  4. 为每个要配置更新源的插件添加一个条目。

    <application> <component name="PluginUpdateSources"> <sources> <entry pluginId="pluginId"> <!-- For a custom repository --> <!-- The custom repository URL is exactly the URL of custom repository with trimmed `/` on the end, as it is configured in IDE --> <updateSource host="<custom repository url>" isMarketplace="false" /> </entry> <!-- Plugin2 will be updated from JetBrains Marketplace or Marketplace proxy for users of ToolBox Enterprise --> <entry pluginId="pluginId2"> <updateSource /> </entry> <entry pluginId="pluginId3"> <updateSource .../> </entry> ... </sources> </component> </application>

提高效率的提示

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

  1. IDE 会打开。

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

  3. 如果插件兼容，系统会提示安装或启用该插件。

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

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

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

2026年 11月 9日
从 NetBeans 迁移到 PhpStormJetBrainsd 服务