IntelliJ IDEA 2025.2 Help

Spring Boot 运行配置

Spring Boot 运行配置定义了如何在 IntelliJ IDEA 中运行您的 Spring Boot 应用程序。 IDE 会在您从主类文件运行应用程序时创建一个 Spring Boot 运行配置。 如需更多信息,请参阅 运行 Spring Boot 应用程序

创建 Spring Boot 运行配置

  1. 在主菜单中,前往 运行(U) | 编辑配置(R)…

  2. 运行/调试配置 对话框中,点击 "添加"按钮 并选择 Spring Boot

Spring Boot 运行配置

名称(N)

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

运行于

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

存储为项目文件(S)

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

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

必填选项

要运行您的 Spring Boot 应用程序,必须使用以下选项:

JRE(J)

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

主类

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

修改选项

点击 修改选项(M) 选择运行配置的其他选项。

修改 Spring Boot 运行配置的选项

Spring

以下选项适用于运行 Spring Boot 应用程序:

有效配置文件

指定应激活的 Spring 配置文件。

这会在命令行上通过 -Dspring.profiles.active ,从而重写 spring.profiles.active 属性。

如需更多信息,请参阅 Spring Boot: Profiles

启用调试输出(D)

启用调试输出的日志记录。

在命令行上传递 -Ddebug ,这与设置 debug 属性类似。

如需更多信息,请参阅 Spring Boot:日志记录

隐藏横幅(H)

完全禁用启动横幅。

这是在命令行上传递 -Dspring.main.banner-mode=OFF ,类似于将 spring.main.banner-mode 属性设置为 off

如需了解更多信息,请参阅 Spring Boot: Customizing the banner

禁用启动优化(Z)

不要加快您的应用程序的启动时间。

默认情况下,可以通过在命令行上传递以下 JVM 选项启用此优化: -XX:TieredStopAtLevel=1-noverify (后者在 JDK 13 及更高版本中已弃用)。 这会以长期性能和安全性为代价减少应用程序的启动时间。 您可以在开发环境中保持启用,但在生产运行中禁用。

禁用 JMX 端点

禁用 JMX 代理,以在 执行器 选项卡的 运行 工具窗口中显示应用程序端点数据。

默认情况下,可以通过在命令行上传递以下 JVM 选项来启用 JMX 代理:

  • -Dcom.sun.management.jmxremote

  • -Dspring.jmx.enabled=true

  • -DSpring.liveBeansView.mbeanDomain

  • -Dspring.application.admin.enabled=true

  • -Dmanagement.endpoints.jmx.exposure.include=*

这会减慢应用启动速度。 如果您禁用 JMX 代理,上述选项将不会添加到命令行。

如需更多信息,请参阅 Spring: JMX

执行“更新”操作时

修改代码并希望更新正在运行的应用程序时,指定应该执行的操作:

  • 不执行任何操作 :请勿更新该应用程序。

  • 更新资源 :更新所有修改过的资源文件。

  • 更新类和资源 :更新所有修改后的资源文件并重新编译所有更改过的 Java 类。

    调试时,IntelliJ IDEA 将部署并重新加载更新的类。 有关更多信息,请参见 重新加载修改的类。 否则,当正常运行应用程序时,IntelliJ IDEA 将只会更新输出文件夹中已更改的类。 是否会在运行中的应用程序中部署和重新加载这些类,取决于您使用的 Java 运行时的功能。

  • 更新触发器文件 :在命令行中传递 -Dspring.devtools.restart.trigger-file=.restartTriggerFile 并更新 .restartTriggerFile 文件,这将启动重启检查:应用程序只会在有事情可做时重启。

  • 热交换类,如果失败则更新触发器文件 :这类似于 更新类和资源 后跟 更新触发器文件

切换出IDE 时:

指定当您从 IntelliJ IDEA 切换到另一个应用程序(例如网络浏览器)时的操作:

  • 不执行任何操作 :请勿更新该应用程序。

  • 更新资源 :更新所有修改过的资源文件。

  • 更新类和资源 :更新所有修改后的资源文件并重新编译所有更改过的 Java 类。

    调试时,IntelliJ IDEA 将部署并重新加载更新的类。 有关更多信息,请参见 重新加载修改的类。 否则,当正常运行应用程序时,IntelliJ IDEA 将只会更新输出文件夹中已更改的类。 是否会在运行中的应用程序中部署和重新加载这些类,取决于您使用的 Java 运行时的功能。

覆盖配置属性(P)

通过将配置属性作为 JVM 选项传递来重写它。 例如,如果您用 my.config 覆盖 spring.config.name 属性的值,IntelliJ IDEA 将在运行这个 Spring Boot 应用程序时在命令行上传递 -Dspring.config.name=my.config

操作系统

以下选项与操作系统相关:

允许多个实例(U)

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

工作目录(W)

指定将用于所有相对输入和输出路径的目录。 默认情况下,IntelliJ IDEA 使用项目根目录作为工作目录。

环境变量(E)

指定运行此配置所需的环境变量的名称和值。

Java

以下选项是针对 Spring 应用程序的 Java 编译器和运行时特定的:

运行前不构建

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

使用模块的类路径(O)

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

修改类路径

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

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

虚拟机选项(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 选项将重写模块的类路径。

程序实参(R)

将命令行参数传递给您的应用程序。

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

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

在 Spring Boot 运行配置中,默认启用此选项。

缩短命令行

选择一种方法来缩短命令行,如果 classpath 太长,或者您有许多超过操作系统命令行长度限制的 VM 参数。 选项的选择取决于类加载器的实现。 请注意,一些框架不支持 JAR manifest ,而其他具有自定义类加载器的框架则无法很好地与 classpath.file 选项一起工作。

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

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

  • classpath.file :IntelliJ IDEA 将把一个长 classpath 写入文本文件。

  • @argFiles (Java 9+) :可以使用 @argument files option 解决命令行长度限制问题。

日志

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

条目

描述

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

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

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

  • 别名(A) :日志将显示在该选项卡中。

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

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

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

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

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

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

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

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

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

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

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

代码覆盖率

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

条目

描述

指定类和软件包

在此表中,指定要测量的类和包。 点击 "添加"按钮 并选择 添加类按钮添加类“ 添加包按钮 ”添加软件包 以指定。 您还可以通过在列表中选择类和包,然后点击 删除这个包 按钮从列表中删除它们。

排除类和软件包

指定您要从覆盖范围中排除的类和包。

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

启动前

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

条目

描述

添加启动前任务

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

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

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

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

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

  • 运行Gradle 任务 :运行一个 Gradle task。 在打开的对话框中,指定任务并在必要时提供附加配置。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

当测试运行时,将重点放在运行配置工具窗口上。

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

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

最后修改日期: 2025年 9月 22日