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

有两种 运行/调试 配置:

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

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

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

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

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

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

当有可执行的类或方法时,您可以 直接从编辑器创建永久运行/调试配置。

将临时运行/调试配置保存为永久配置。

从模板创建或复制现有配置。

从可执行方法或类创建永久运行/调试配置将文本光标置于可执行方法或类(例如,带有 main() 方法的类或测试套件)的声明处,然后按 Alt+Enter。

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

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

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

将临时配置保存为永久配置在 运行小部件 中选择一个临时配置,点击 并选择 保存配置。

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

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

从模板创建运行/调试配置前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0。

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

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

指定配置选项。

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

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

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

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

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

条目

快捷键

描述

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

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

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

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

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

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

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

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

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

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

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

/.idea/*

!/.idea/runConfigurations

启用 存储为项目文件(S) 选项不会将任何内容提交到 VCS。 为了使 运行/调试 配置进入共享存储库,您必须像其他版本化文件一样将它们签入。

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

配置模板的默认值前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0。

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

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

请指定所需的默认参数,然后点击 OK 以保存模板。

您可以像常规运行/调试配置一样与您的团队成员 共享运行/调试配置模板。

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

为运行/调试配置创建一个文件夹前往 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后按 0。

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

为文件夹命名。

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

最后修改日期: 2025年 4月 24日运行应用程序运行/调试配置:应用程序