IntelliJ IDEA 2025.3 Help

运行/调试配置:应用程序

应用程序 是 Java 应用程序最基本的运行/调试配置模板。 此配置会编译并运行您的 Java 程序——类似于使用 javac 和 java 命令时的操作。 。

打开运行配置

  1. 在主菜单中,前往 运行 | 编辑配置。

  2. 在 运行/调试配置 对话框中:

    • 要创建新配置,请点击 添加 工具栏上的或者按下 Alt+Insert 并选择 应用程序。

    • 或者,点击左侧列表中的现有 应用程序 配置。

    在右侧,您将看到配置选项。

运行/调试配置:应用程序

名称(N)

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

运行于

选择您要运行配置的目标环境。 除了在本地运行之外,您还可以选择通过 SSH 在远程机器上或在 Docker 容器中运行您的应用程序。 有关更多信息,请参见 运行目标。

存储为项目文件(S)

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

默认情况下,此选项是禁用的,IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

必填选项

条目

描述

JRE(J)

指定 IntelliJ IDEA 应该使用的运行时环境来运行应用程序。 默认情况下,IntelliJ IDEA 使用模块依赖项中最新可用的 JDK。

主类

指定要执行的类的完全限定名称。

程序实参(R)

指定要以命令行格式传递给应用程序的参数列表。 使用与指定 VM 选项相同的规则。

工作目录(W)

指定用于运行应用程序的工作目录。 此目录是所有相对输入和输出路径的起点。 默认情况下,工作目录是项目根目录。

更多选项

您还可以为 应用程序 运行/调试配置类型配置其他属性。 要访问它们,请点击 修改选项:

运行/调试配置:应用程序,更多选项

操作系统

条目

描述

允许多个实例(U)

允许此运行配置的多个实例同时执行。 默认情况下,此选项是禁用的,这意味着当您运行该配置时,其他活动的配置会话将终止。

环境变量(E)

点击 浏览按钮 打开 环境变量 对话框,您可以在其中创建变量并指定其值。

重定向输入

启用将文本文件中的数据重定向到标准输入。 如果您的程序需要一些输入,并且您希望从文件中读取值而不是在 运行 控制台中键入它们,请使用此选项。 要启用重定向,请选中复选框并指定目标文本文件的路径。

Java

以下选项特定于 Java 编译器和运行时:

条目

描述

运行前不构建

无需启动构建过程即可立即运行应用程序。

使用模块的类路径(O)

选择应使用其类路径来运行应用程序的模块。

修改类路径

如有必要,请指定另一个 classpath 或选择您想从 classpath 排除的 dependencies。 当运行时类路径与编译类路径不同时(例如调试库、不同位置等),此选项是必要的。

请使用 向上 和 向下 按钮对列表中的依赖项进行排序。 依赖项的顺序很重要,因为 IntelliJ IDEA 会按照列表中指定的顺序处理它们。

将带有"provided" 作用域的依赖项添加到类路径

将具有 已提供 作用域的依赖项添加到运行时类路径。

缩短命令行

选择一种方法,用于在类路径过长或 VM arguments 过多、超过操作系统的命令行长度限制时缩短命令行。 选项的选择取决于类加载器的实现。 请注意,某些框架不支持 JAR 清单 ,而具有自定义类加载器的其他框架与 classpath.file 选项配合使用效果不佳。

  • 无 :IntelliJ IDEA 将不会缩短过长的类路径。 如果命令行超过操作系统的限制,IntelliJ IDEA 将无法运行您的应用程序,并会显示一条消息,建议您指定缩短方法。

  • JAR 清单 :IntelliJ IDEA 将通过临时的 classpath.jar 传递过长的类路径。 原始类路径在 清单 文件的 classpath.jar 中,作为 class-path 属性定义。 请注意,如果使用此方法缩短了命令行,您将能够预览完整的命令行,而不仅仅是临时的 classpath.jar 的类路径。

  • classpath.file :IntelliJ IDEA 将把过长的类路径写入一个文本文件。

  • @argFiles (Java 9+) :将使用 @参数文件选项 来绕过命令行长度限制。

虚拟机选项(V)

指定启动应用程序时传递给 Java 虚拟机的选项,例如, -mx、 -verbose 等。

在指定 JVM 选项时,请遵循以下规则:

  • 使用空格来分隔各个选项。

  • 如果选项的值包含空格,请用双引号括起值或实际空格。

  • 如果选项的值中包含双引号,请使用反斜杠对双引号进行转义。

  • 您可以将环境变量值传递给自定义 Java 属性。

-Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}

在此字段中使用代码补全:开始输入标志的名称,IDE 会建议可用的命令行选项列表。 这适用于 -XX: 和 -X 选项以及一些未由IntelliJ IDEA自动配置的标准选项,如 -ea ,但不适用于 -cp 或 –release。

此字段中指定的 -classpath 选项将重写模块的类路径。

日志

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

条目

描述

指定要在控制台中显示的日志

指定在运行应用程序时显示哪些日志文件。

点击 "添加"按钮 添加新日志。 在 编辑日志文件别名 对话框中,配置以下内容:

  • 别名(A) :日志将显示的选项卡名称。

  • 日志文件位置(L) :指定日志文件的路径或 Ant 模式。 如果多个滚动日志文件匹配该模式,IntelliJ IDEA 将显示最新的一个。

  • 显示可由模式覆盖的所有文件(S) :显示所有匹配该模式的日志。

对于表中的日志,您可以配置以下选项:

  • 处于活动状态 :显示指定的日志文件。

  • 跳过内容 :不显示先前运行的旧日志消息。

将控制台输出保存到文件(S)

将控制台输出保存到指定位置。 手动输入路径,或点击浏览按钮,然后在 打开的对话框 中指向所需位置。

在消息打印到stdout 时显示控制台

当应用程序写入标准输出流时激活控制台。

在消息打印到stderr 时显示控制台

当应用程序写入标准错误流时激活控制台。

代码覆盖率

以下选项与代码覆盖率相关。 有关更多信息,请参见 代码覆盖率。

条目

描述

指定类和软件包

在此表中,指定要测量的类和包。 点击 "添加"按钮 并选择 添加类按钮添加类 或 "添加软件包"按钮添加包 以指定。 您还可以在列表中选中它们,然后点击 移除该软件包 按钮,以从列表中移除类和包。

排除类和软件包

指定要从覆盖率中排除的类和包。

点击 "添加"按钮 并选择 添加类按钮添加类 或 "添加软件包"按钮添加包 以指定类和包。

启动前

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

条目

描述

添加启动前任务

启用此选项以添加以下可用任务之一:

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

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

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

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

  • 运行Gradle 任务 :运行 Gradle 任务。 在打开的对话框中,指定任务并在必要时提供其他配置。

  • 构建 :选择编译指定的模块。 构建模块 操作将被执行。

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

  • 构建项目 :选择编译整个项目。 构建项目操作将被执行。

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

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

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

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

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

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

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

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

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

    指定 Node.js 运行时的位置、要传递给它的参数,以及 gulp 包的路径。

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

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

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

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

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

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

启动时打开运行/调试工具窗口

根据配置类型,在启动此运行配置时,打开 运行、 调试 或 服务 工具窗口。 如果此选项被禁用,您可以手动打开工具窗口:

  • 视图(V) | 工具窗口 | 运行 或 Alt+4

  • 视图(V) | 工具窗口 | 调试 或 Alt+5

  • 视图(V) | 工具窗口 | 服务 或 Alt+8

启动时使“运行/调试”工具窗口获得焦点

测试运行时,将焦点置于运行配置工具窗口。

开始前显示运行/调试配置设置

在实际启动之前显示运行配置设置。

2026年 1月 23日