PhpStorm 2025.2 Help

运行/调试配置

PhpStorm 使用运行/调试配置来运行、调试和测试您的代码。 每个配置是一组命名的启动属性，用于定义要执行的内容以及应使用的参数和环境。

有两种 运行/调试 配置：

  • 临时 — 每次您从上下文菜单中选择 运行 <item_name> 时创建。 要调用上下文菜单，请右键单击一个对象或区域。

  • 永久—由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分，直到您删除它们。

每当您运行、调试或测试代码时，PhpStorm 要么使用现有的永久运行/调试配置，要么创建一个新的临时配置。

永久配置的图标是不透明的，而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

临时配置的最大数量为 5。 添加新版本时，旧版本会被自动删除。 如有必要，您可以在 设置 | 高级设置 | 运行/调试 | 临时配置限制 中增加此限制。

永久配置和临时配置有不同的图标

创建永久运行/调试配置

PhpStorm 提供以下方法来创建永久运行/调试配置：

从编辑器创建永久运行/调试配置

  1. 在编辑器中，将插入符号放置在可执行声明处（例如测试方法或类），然后按 Alt+Enter。

  2. 从打开的菜单中，选择 修改运行配置。

    为类创建运行配置

    PhpStorm 创建一个对应类型的永久运行/调试配置，并打开一个对话框，您可以在其中设置配置参数。

将临时配置保存为永久配置

  • 在 运行/调试 配置切换器中选择一个临时配置，单击 / 并选择 保存配置。

    保存临时运行配置

  • 或者，在“运行/调试配置”对话框中选择一个临时配置，然后点击工具栏上的 保存。

PhpStorm 为不同的语言、工具和框架提供运行/调试配置 模板。 可用模板的列表会因已安装和启用的 plugins 而有所不同。

从模板创建运行/调试配置

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 运行/调试配置 对话框中，点击工具栏上的 或按 Alt+Insert。 该列表显示运行/调试配置模板。

    选择所需的模板。 如果您不确定选择哪个模板，请参阅 运行/调试配置对话框 以获取有关特定模板的更多信息。

    选择新的运行/调试配置模板

  3. 在 名称 字段中指定运行/调试配置名称。 此名称将用于在列表和菜单中标识运行/调试配置。

  4. 如果您希望允许同时运行多个配置实例，请选择 允许多个实例(U)。 如果禁用此选项，尝试重新运行配置将终止活动会话。

  5. 配置运行/调试配置参数。 必需参数和可选参数的列表可能因所选运行/调试配置类型而异。

    某些可选参数是隐藏的。 要查看并启用它们，请单击 修改选项 链接。

    有关所选模板的详细描述，请参阅 运行/调试配置参考的相应部分。

  6. 在 启动前 部分中，定义是否希望在启动应用程序之前执行任何特定操作，例如在启动运行/调试配置之前执行一些工具或脚本。

    有关特定 启动前 活动的更多信息，请参阅 启动前。

  7. 您可以立即运行该配置，也可以保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行，请单击 确定。

    • 若要立即运行此配置，请点击 运行。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按照它们在列表中出现的顺序执行。

项目

快捷方式

描述

"添加"按钮

Alt+Insert

点击此图标以添加下列可用任务之一：

  • 启动Web 浏览器 ：选择此选项即可启动浏览器。 在打开的对话框中，选择浏览器的类型并提供起始 URL。 此外，指定是否希望浏览器以启用 JavaScript 调试器的方式启动。

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择您要运行的一个或多个应用程序。 如果在 PhpStorm 中尚未定义，请添加其定义。 如需更多信息，请参阅 外部工具 和 外部工具。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。

  • 运行File Watcher ：选择此选项以让 PhpStorm 应用所有当前活动的 文件监视器。

  • 运行远程外部工具 ：添加一个 远程 SSH 外部工具。

  • 运行Grunt 任务 ：选择此选项来运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、要传递给它的参数，以及 grunt-cli 包的路径。

  • 运行gulp 任务 ：选择此选项以运行 Gulp task。

    在打开的 Gulp 任务 对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给解释器的参数以及到 gulp 包的路径。

  • 运行npm 脚本 ：选择此选项来执行一个 npm 脚本。

    在 NPM Script 对话框中，指定 npm run/debug configuration settings。

  • 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为:

    • 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。

  • 生成CoffeeScript 源映射 ：选择此选项以生成 CoffeeScript 源代码的源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。

  • 上传文件到远程主机 ：选择此选项以根据 默认服务器访问配置自动 上传应用程序文件到服务器。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

点击此图标可编辑选定的任务。 请在打开的对话框中进行必要的更改。

方法向上

方法 down

Alt+Up

Alt+Down

点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，在配置运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

共享运行/调试配置

您可能希望共享您的 运行/调试 配置，以便您的团队成员可以使用相同的配置运行应用程序，或者使他们能够远程附加到您正在运行的进程。

PhpStorm 提供了一种机制，可以将您的 运行/调试 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时，也可以使用相同的机制。

传统 .ipr -based 项目不支持单独的 运行/调试 配置。 对于传统项目，您只能通过将 .ipr 文件添加到 VCS 来一次性共享所有配置。

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 请选择您要共享的 运行/调试 配置，启用 存储为项目文件(S) 选项，并指定配置文件的存储位置。

    您可以配置任何位置，除非需要与 PhpStorm 2019.3 及更早版本兼容。 为了与这些版本兼容，请将文件存储在建议的位置。

    存储为项目文件框

  3. （可选）如果将 .idea 目录添加到 VCS 忽略文件中，那么 .idea/runConfigurations 子文件夹也将被忽略。 如果项目使用 Git，您可以共享 .idea/runConfigurations 并保留 .idea 被忽略，通过修改 .gitignore 如下：

    /.idea/* !/.idea/runConfigurations

运行/调试配置模板

所有运行/调试配置都基于模板，这些模板实现了启动逻辑，定义参数列表及其默认值。 安装中预定义了 可用模板列表 ，只能通过 插件进行扩展。 但是，您可以编辑每个模板中的默认参数值，以便于新运行/调试配置的设置。

配置模板的默认值

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 运行/调试 配置对话框的左侧窗格中，点击 编辑配置模板…。

  3. 在打开的 运行/调试配置模板 对话框中，选择一个配置类型。

    运行/调试模板

  4. 请指定所需的默认参数，然后点击 确定 以保存模板。

运行/调试配置文件夹

当有许多相同类型的 运行/调试 配置时，您可以将它们分组到文件夹中以便于访问。

运行配置的文件夹

为运行/调试配置创建一个文件夹

  1. 转到 运行 | 编辑配置。 或者，按 Alt+Shift+F10 ，然后 0。

  2. 在 运行/调试配置 对话框中，选择配置类型并在工具栏上点击 新建文件夹图标。 已创建一个新的空文件夹用于所选类型。

  3. 请在右侧的文本框中指定文件夹名称或接受默认名称。

  4. 选择所需的 运行/调试 配置并将它们移动到目标文件夹下。

  5. 应用这些更改。 如果一个文件夹是空的，它将不会被保存。

当您不再需要文件夹时，可以将其删除 Delete。 此文件夹下的 运行/调试 配置将被移动到相应 运行/调试 配置类型的根目录下。

服务工具窗口中的运行/调试配置

您可以在 服务 工具窗口中管理多个 run/debug 配置。 例如，您可以启动、暂停和停止多个应用程序，跟踪它们的状态，并检查特定于应用程序的详细信息。

将运行/调试配置添加到 服務 窗口

  1. 从主菜单中选择 视图 | 工具窗口 | 服务 或按 Alt+8。

  2. 在 服务 工具窗口中，点击 添加服务 ，然后选择 Run Configuration Type…。

    服务工具窗口：添加运行配置

  3. 从列表中选择运行/调试配置类型，将此类型的所有配置添加到窗口。

    请注意，工具窗口将仅显示您已 创建 一个或多个配置的配置类型。

最后修改日期： 2025年 9月 26日
教程：在 PhpStorm 中部署运行/调试代码