505,044
社区成员




IntelliJ IDEA 使用运行/调试配置来运行、调试和测试您的代码。每个配置都是一组命名的启动属性,用于定义要执行的内容以及应使用的参数和环境。
为特定类型的可执行上下文创建新配置时,可以从实现启动逻辑的专用配置模板之一创建该配置模板,并定义参数列表及其默认值。可用模板的列表在安装中预定义,只能通过插件 扩展。但是,您可以编辑每个模板中参数的默认值,以简化新配置的创建。
如果导航栏可见(查看|外观|导航栏),您可以从工具栏上的选择器访问所有可用的 %run_debug% 配置。
运行/调试配置可以创建为:
Temporary — 每次运行没有永久配置的类时创建。它提供了允许具有该方法的类运行的最低限度。main()
临时配置的最大数目为 5。添加新的时,旧的会自动删除。如有必要,您可以在"设置"/"首选项"中增加此限制|高级设置|IDE |临时运行/调试配置限制。
永久— 从模板显式创建或通过保存临时配置创建。永久配置将保留为项目的一部分,直到您将其删除。
因此,每当您运行/调试或测试代码时,IntelliJ IDEA要么使用现有的永久运行/调试配置,要么创建新的临时配置。
永久配置具有不透明的图标,而临时配置的图标是半透明的。
IntelliJ IDEA 提供了以下方法来创建永久运行/调试配置:
当存在可执行类或方法时,可以直接从编辑器创建永久运行/调试配置。
从模板创建或复制现有配置。
将插入符号放在可执行方法或类的声明处(例如,具有该方法或测试套件的类),然后按 。IntelliJ IDEA 创建相应类型的永久运行/调试配置。main()
Alt+Enter
设置运行/调试配置参数。有关模板的详细说明,请参 阅运行/调试配置列表。
在运行/调试配置切换器中选择一个临时配置,然后单击"保存配置"。
或者,在"运行/调试配置"对话框中选择一个临时配置,然后单击工具栏。
IntelliJ IDEA为不同的语言,工具和框架提供运行/调试配置模板。可用模板的列表因已安装和启用的插件而异。
此过程描述使用应用程序模板创建运行/调试配置的步骤。这是 Java 最常见的模板,它对应于编译程序,然后使用 运行它。有关其他模板,请参 阅运行/调试配置列表。
javac
java
通过以下方式之一打开"运行/调试配置"对话框:
选择运行|从主菜单中编辑配置。
导航栏可见(查看|外观|导航栏),从运行/调试配置选择器中选择"编辑配置"。
按,然后按 。Alt+Shift+F100
在"运行/调试配置"对话框中,单击工具栏或按 。该列表显示运行/调试配置模板。选择"应用程序"。Alt+Insert
在"名称"字段中指定运行/调试配置名称。此名称将显示在可用运行/调试配置的列表中。
在"生成并运行"部分中,指定下面列出的参数。要使用键盘访问字段,请按住并根据出现的提示使用快捷方式。Alt
JDK 或 JRE – 将用于运行程序的 JDK/JRE。
主类– 主类定义应用程序的入口点。对于要用作 main 的类,它应包含该方法。public static void main(String[] args)
程序参数– 要传递给应用程序的命令行参数。在运行时,它们将作为数组中的字符串提供。如果参数内部有空格,请将其括在双引号中,例如:。args
arg1 arg2 "long argument"
大多数字段都具有"展开"
和"宏"选项。展开有助于在字段太长时进行编辑。宏为您省去了插入和维护可能随时间变化的参数的繁琐工作。
如果要微调应用程序的启动方式,请单击"修改选项"以访问更高级的运行/调试配置功能。选择项目时,该项目将添加到对话框中。同样,您可以删除未使用的选项。
以下选项可用:
允许多个实例– 选择是否要允许此程序的多个实例同时运行。如果禁用此选项,则尝试重新运行应用程序将终止活动会话。
环境变量– 将流程的环境变量指定为键值对,并用分号分隔它们,例如 .您可以覆盖系统变量以及定义自定义变量。HOME=/home/me.user;MY_APP_DATA=/home/me.user/appdata
如果该行太长,请单击"编辑环境变量"。将打开一个单独的对话框,您可以在其中管理类似表的视图中的变量、复制/粘贴它们等。
重定向输入– 允许您从文件而不是控制台获取程序输入。
运行前不生成– 选择立即运行程序而不启动生成过程。
添加 VM 选项– 指定用于运行应用程序的 VM 选项。选项使用空格分隔。如果选项内部有空格,请将其括在双引号中。如果双引号是选项的一部分,请使用反斜杠对它们进行转义,例如 。此外,还可以将环境变量传递给选项,例如 。-Dsome_option=\"value\"
-Dsome_option=${ENVIRONMENT_VARIABLE}
使用模块的类路径– 将使用其类路径的模块。VM 选项中指定的类路径优先于此类路径。
缩短命令行– 指定命令行缩短器。当程序因类路径超过操作系统施加的限制而无法启动时,请使用此选项。您可以将类路径传递到临时 JAR、文本文件,或使用缺省从(对于旧项目)。idea/workspace.xml
日志– 有关设置日志记录的信息,请参阅查看日志。
代码覆盖率选项– 有关设置覆盖率的信息,请参阅配置覆盖率。
启动前– 定义是否要在启动应用程序之前执行任何特定操作,例如,编译修改后的源或运行 Ant 或 Maven 脚本。
应用更改并关闭对话框。
当您停止程序时,其进程将中断并立即退出。暂停程序时,该程序将继续在后台运行,但其输出已挂起。
出于这些目的,IntelliJ IDEA 提供了一种机制,用于将运行/调试配置存储为项目文件,并通过 VCS 共享它们。当您要将配置作为文件发送给其他人时,也可以使用相同的机制。这节省了大量时间,因为运行/调试配置有时会变得复杂,并且手动保持它们同步将是繁琐且容易出错的。
基于.ipr的旧版项目不支持单独的运行/调试配置。对于旧项目,您只能通过将.ipr文件添加到 VCS 来一次共享所有配置。
从主菜单中,选择"运行|编辑配置。或者,按 ,然后按 。Alt+Shift+F100
选择要共享的运行/调试配置,启用"存储为项目文件"选项,并指定配置文件的存储位置。
如果需要与 IntelliJ IDEA 2019.3 及更早版本兼容,请将文件存储在默认位置。
(可选)如果将 .idea目录添加到 VCS 忽略的文件中,则.idea/runConfigurations子文件夹也将被忽略。如果将 Git 用于项目,则可以仅共享.idea/runConfigurations,并通过修改.gitignore来忽略.idea,如下所示:
<span style="background-color:var(--wh-color-backlight-main)"><span style="color:var(--wh-color-text-main)"><code>/.idea/*
!/.idea/runConfigurations</code></span></span>
打开"存储为项目文件"选项不会为您向 VCS 提交任何内容。要使运行/调试配置进入共享存储库,您必须像签入其他版本化文件一样签入它们。
要了解如何从 VCS 导入运行/调试配置,请参阅版本控制部分。
如果您的程序中存在错误,请按以下方法解决这些错误。
更改模板的默认值不会影响现有的运行/调试配置。
从主菜单中,选择"运行|编辑配置。或者,按 ,然后按 。Alt+Shift+F100
在"运行/调试配置"对话框的左侧窗格中,单击"编辑配置模板"。
在打开的"运行/调试配置模板"对话框中,选择配置类型。
指定所需的默认参数,然后单击确定以保存模板。
您可以与团队成员共享运行/调试配置模板,就像常规运行/调试配置一样。
假设您要同时启动多个运行/调试配置。例如,您可能希望运行多个不同类型的配置或一组测试配置。可以使用复合运行/调试配置来配置此行为。
不保证执行顺序。如果需要按顺序运行运行/调试配置,请在运行/调试配置的"启动前"区域中定义应最后运行的序列。
从主菜单中,选择"运行|编辑配置。或者,按 ,然后按 。Alt+Shift+F100
在"运行/调试配置"对话框中,单击或按 ,然后选择"复合"。Alt+Insert
在"名称"字段中指定运行/调试配置名称。此名称将显示在可用运行/调试配置的列表中。
若要将新的运行/调试配置包含在复合配置中,请单击"添加",然后从列表中选择所需的配置。
应用更改。
您可以查看所有活动运行或调试会话的列表,并在它们之间导航。
分组后,运行/调试配置将显示在相应文件夹下的列表中。
从主菜单中,选择"运行|编辑配置。或者,按 ,然后按 。Alt+Shift+F100
在"运行/调试配置"对话框中,选择配置类型,然后单击工具栏。将为所选类型创建一个新的空文件夹。
在右侧的文本字段中指定文件夹名称,或接受默认名称。
选择所需的运行/调试配置,并将其移动到目标文件夹下。
应用更改。如果文件夹为空,则不会保存该文件夹。
当您不再需要某个文件夹时,可以将其删除。在此文件夹下分组的运行/调试配置将移动到相应运行/调试配置类型的根目录下。Delete