IntelliJ IDEA 2025.1 Help

运行/调试配置

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

有两种 运行/调试 配置:

  • 临时 — 每次您 运行没有永久配置的类时都会创建。 它提供了使具有 main() 方法的类运行的最低要求。

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

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

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

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

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

创建永久运行/调试配置

IntelliJ IDEA 提供以下方法来创建永久运行/调试配置:

从可执行方法或类创建永久运行/调试配置

  1. 将文本光标置于可执行方法或类(例如,带有 main() 方法的类或测试套件)的声明处,然后按 Alt+Enter

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

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

    为类创建运行配置
  3. 设置运行/调试配置参数。 如需查看模板的详细描述,请参阅 运行/调试配置列表

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

  • 运行小部件 中选择一个临时配置,点击 并选择 保存配置

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

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

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

  1. 前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0

  2. 运行/调试配置 对话框中,点击工具栏上的 或按下 Alt+Insert。 列表显示运行/调试配置模板。 请选择一个模板,例如 应用程序。 此配置编译并运行您的 Java 程序——类似于使用 javacjava 命令。

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

  4. 指定配置选项。

    如需更多信息,请参阅 运行/调试配置:应用程序 (运行简单的 Java 应用程序)或 运行/调试配置模板列表 (其他运行配置)。

  5. 您可以立即运行配置或保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行,请点击 确定

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

启动前

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

条目

快捷键

描述

"添加"按钮

Alt+Insert

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

  • 启动Web 浏览器 :选择此选项以启动浏览器。 在打开的对话框中,选择浏览器类型并提供起始 URL。 此外,指定是否希望浏览器与 JavaScript 调试器一起启动。

  • 运行外部工具 :选择运行外部应用。 在打开的对话框中,选择您想要运行的一个或多个应用程序。 如果它在 IntelliJ IDEA 中尚未定义,请添加其定义。 如需更多信息,请参阅 外部工具外部工具设置

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

  • 构建 :选择编译指定的模块。 Build Module命令 将会被执行。

    如果在编译过程中发生错误,IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建项目 :选择编译整个项目。 Build Project 命令 将被执行。

    如果在编译过程中发生错误,IntelliJ IDEA 将不会尝试启动运行/调试配置。

  • 构建,不检查错误 :与 构建 选项相同,但 IntelliJ IDEA 将会尝试启动运行/调试配置,而不考虑编译结果。

  • 构建物 :选择此选项以构建一个或多个 构件。 在打开的对话框中,选择应构建的 artifact。

  • 运行Grunt 任务 :选择此选项以运行 Grunt 任务。

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

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

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

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

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

  • 运行 Maven Goal :选择此选项以 运行一个 Maven 目标。 在打开的对话框中,选择要运行的目标。

  • 运行npm 脚本 :选择此选项以执行 npm script。

    在打开的 NPM 脚本 对话框中,指定 npm 运行/调试配置设置

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

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

    • 如果取消选中 检查错误 复选框,编译器将显示所有检测到的错误,但仍会启动运行配置。

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

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

  • 断开数据源 :如果您希望在运行/调试配置运行之前中断与数据源的连接,请选择此选项。

"移除"按钮

Alt+Delete

点击此图标以从列表中删除所选任务。

编辑

Enter

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

方法 up

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下,将选中此复选框,启动运行/调试配置时将打开 RunDebug 工具窗口。

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

共享运行/调试配置

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

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

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

  1. 前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0

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

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

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

    /.idea/* !/.idea/runConfigurations

运行/调试配置模板

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

配置模板的默认值

  1. 前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0

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

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

    运行/调试模板
  4. 请指定所需的默认参数,然后点击 OK 以保存模板。

运行/调试配置文件夹

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

分组运行配置

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

  1. 前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0

  2. 选择您想要移动到文件夹的运行/调试配置,然后点击 移动到新文件夹图标

    在文件夹中分组配置
  3. 为文件夹命名。

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

最后修改日期: 2025年 4月 24日