运行/调试配置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日运行应用程序运行/调试配置:应用程序