运行调试配置：JAR 应用程序

此运行/调试配置使您能够运行通过 java -jar <name>.jar 命令启动的应用程序。

配置选项卡

条目	描述
JAR 路径	指定所需 JAR 文件的绝对路径。
程序参数	以在命令行中使用的格式输入要传递给程序的参数列表。请使用与指定 VM options 相同的规则。
工作目录	指定用于运行应用程序的工作目录。此目录是所有相对输入和输出路径的起点。默认情况下，该字段包含项目文件所在的目录。要指定其他目录，请点击并选择该目录。展开列表以查看可用的路径变量，您可以将其用作工作目录的路径。路径变量列表可能会因启用的插件而异。
环境变量	创建环境变量并指定其值。
将带有"provided" 作用域的依赖项添加到类路径	启用此选项可将具有已提供范围的依赖项添加到运行时类路径。
缩短命令行	当类路径过长或 VM 参数过多而超过操作系统的命令行长度限制时，选择一种用于缩短命令行的方法：无：IntelliJ IDEA 将不会缩短过长的类路径。如果命令行超过操作系统的限制，IntelliJ IDEA 将无法运行您的应用程序，并会显示一条消息，建议您指定缩短方法。 JAR 清单：IntelliJ IDEA 将通过临时的 classpath.jar 传递过长的类路径。原始类路径在 manifest 文件的 classpath.jar 中，作为 `class-path` 属性定义。如果使用此方法缩短了命令行，您将能够预览完整的命令行，而不仅仅是临时 classpath.jar 的类路径。类路径文件：IntelliJ IDEA 将把过长的类路径写入一个文本文件。
JRE	默认情况下，使用来自模块依赖项的最新 JDK 运行应用程序。如果您希望在此指定其他 JDK 或 JRE，请从列表中选择。
使用模块的类路径搜索源	请使用列表选择所需模块。此选项告诉调试器和功能从堆栈跟踪导航，应从哪里查找 JAR 存档中的类的源代码。

代码覆盖率选项卡

使用此选项卡配置代码覆盖率监控选项。

条目	描述
要在覆盖率数据中包含的包和类	点击并选择添加类或添加包以指定要测量的类和包。您还可以在列表中选中它们，然后点击按钮，以从列表中移除类和包。
要在覆盖率数据中排除的包和类	点击并选择添加类或添加包以指定不应测量的类和包。您还可以在列表中选中它们，然后点击按钮，以从列表中移除类和包。

日志标签

使用此选项卡指定运行或调试时生成的日志文件应显示在控制台上，即 Run 或调试工具窗口的专用选项卡上。

条目	描述
处于活动状态	选中此列中的复选框以在运行工具窗口或调试工具窗口中显示日志条目。
日志文件条目	此列中的只读字段列出了要显示的日志文件。列表可以包含：特定文件的完整路径。 Ant 模式定义要显示的文件范围。用于替代完整路径或模式的别名。这些别名也显示在选项卡的标题中，对应的日志文件在其中显示。如果日志条目模式定义了多个文件，选项卡标题将显示文件名而不是日志条目别名。
跳过内容	选中此复选框以跳过所选日志的先前内容。
将控制台输出保存到文件	选择此复选框以将控制台输出保存到指定位置。请手动输入路径，或点击浏览按钮并指向打开的对话框中的所需位置。
在消息打印到标准输出流时显示控制台	选中此复选框以激活输出控制台，并在关联进程写入 Standard.out 时将其前置。
在消息打印到标准错误流时显示控制台	选中此复选框以激活输出控制台，并在相关进程写入 Standard.err 时将其置于前端。
	点击此按钮以打开编辑日志文件别名对话框，在此对话框中您可以选择一个新的日志条目并为其指定别名。
	点击此按钮以在编辑日志文件别名对话框中编辑所选日志文件条目的属性。
	点击此按钮从列表中删除所选日志条目。

通用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

条目	描述
名称(N)	在编辑或运行时，指定运行配置的名称以便快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。
存储为项目文件(S)	将运行配置设置的文件保存下来，与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

条目

描述

名称(N)

在编辑或运行时，指定运行配置的名称以便快速识别。

允许多个实例(U)

允许并行运行此运行配置的多个实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。

存储为项目文件(S)

将运行配置设置的文件保存下来，与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。

默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

启动前

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

条目	快捷键	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，指定是否希望浏览器与 JavaScript 调试器一起启动。运行外部工具：选择运行外部应用。在打开的对话框中，选择您想要运行的一个或多个应用程序。如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具设置。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。构建：选择编译指定的模块。 Build Module命令将会被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建项目：选择编译整个项目。 Build Project 命令将被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建，不进行错误检查：与构建选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。构建制品：选择此选项以构建一个或多个构件。在打开的对话框中，选择应构建的 artifact。运行远程外部工具：添加一个远程 SSH 外部工具。运行Grunt 任务：选择此选项以运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp 任务。在打开的 Gulp 任务对话框中，请指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。运行 Maven 目标：选择此选项以运行一个 Maven 目标。在打开的对话框中，选择要运行的目标。运行npm 脚本：选择此选项以执行 npm script。在打开的 npm 脚本对话框中，指定 npm 运行/调试配置设置。编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除检查错误复选框，以配置在检测到任何错误时编译器的行为：如果选中检查错误复选框，编译器将显示所有错误，运行配置将不会启动。如果取消选中检查错误复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。断开数据源：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。
	`Alt+Delete`	点击此图标以从列表中删除所选任务。
	`Enter`	点击此图标以编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标可以将所选任务在列表中上下移动一行。任务按照它们在列表中出现的顺序执行。
显示此页面		选中此复选框，以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，将选中此复选框，启动运行/调试配置时将打开 Run 或 Debug 工具窗口。否则，如果复选框被清除，工具窗口将被隐藏。但是，当配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。
使工具窗口获得焦点		选中此复选框可在启动运行/调试配置时，自动将焦点移动到 Run或 Debug工具窗口。

日志

以下选项与记录此配置的执行相关。有关更多信息，请参见日志。

条目	描述
指定要在控制台中显示的日志	指定在运行应用程序时显示哪些日志文件。点击添加新日志。在编辑日志文件别名对话框中，配置以下内容：别名(A) ：日志将显示的选项卡名称。日志文件位置(L) ：指定日志文件的路径或 Ant 模式。如果多个滚动日志文件匹配该模式，IntelliJ IDEA 将显示最新的一个。显示可由模式覆盖的所有文件(S) ：显示所有匹配该模式的日志。对于表中的日志，您可以配置以下选项：处于活动状态：显示指定的日志文件。跳过内容：不显示先前运行的旧日志消息。
将控制台输出保存到文件(S)	将控制台输出保存到指定位置。手动输入路径，或点击浏览按钮，然后在打开的对话框中指向所需位置。
在消息打印到stdout 时显示控制台	当应用程序写入标准输出流时激活控制台。
在消息打印到stderr 时显示控制台	当应用程序写入标准错误流时激活控制台。

2026年 3月 24日