# 运行/调试配置：Tomcat 服务器

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> `运行 | 编辑配置 | ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) | Tomcat 服务器`

请使用 Tomcat 服务器 [run/debug configuration](run-debug-configuration.html)来部署并调试您的应用程序在 [Tomcat](https://tomcat.apache.org/)上。 如需更多信息，请参阅 [应用服务器运行配置](creating-run-debug-configuration-for-application-server.html)。

* 使用 本地 配置来运行应用服务器的本地实例并将构件部署到其中。

* 请使用 远程 配置将构件部署到正在运行的应用服务器实例。 > **Note:** > 即使您正在连接到远程应用服务器，您仍然需要在本地安装按 构建、执行、部署 | 应用服务器 中所述配置的此服务器，如 [与应用服务器集成](configuring-and-managing-application-server-integration.html) 中所述。

Procedure: 启用 Tomcat 和 TomEE 插件

此功能依赖于 [Tomcat 和 TomEE](https://plugins.jetbrains.com/plugin/20209) 插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Tomcat 和 TomEE  插件并点击   启用  。

##  本地配置的服务器选项卡 

|  条目  |  描述  |
| --- | --- |
|  应用程序服务器  |  请选择要使用的服务器配置。    点击   配置   以创建新的服务器配置或编辑现有配置。 （ [应用程序服务器对话框](application-servers-settings.html)将打开。）     |
|  在启动后  |  选中此复选框以在启动服务器并部署工件后启动一个网页浏览器。    从列表中选择浏览器。 点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) 以配置 Web 浏览器。     |
|  使用 JavaScript 调试器  |  如果选中此复选框，Web 浏览器将以启用 JavaScript 调试器的状态启动。    请注意，JavaScript 调试仅适用于 Firefox 和 Google Chrome。 首次在 Firefox 中调试 JavaScript 时，将安装 JetBrains Firefox 扩展程序。     |
|  URL  |  指定服务器启动时浏览器应打开的 URL。 在大多数典型情况下，此 URL 对应于 Web 应用程序的根目录或起始页面。  |
|    VM 选项    |     指定启动应用程序时要传递给 Java 虚拟机的选项，例如  `-mx` 、  `-verbose`  等。       指定 JVM 选项时，请遵循以下规则：        * 使用空格来分隔各个选项。    * 如果选项的值包含 Space，请用双重引用符将该值或实际的 Space 括起来。    * 如果选项包含作为值一部分的双重引用符，请使用反斜杠对双重引用符进行转义。    * 您可以将环境变量值传递给自定义 Java 属性。      ```PLAINTEXT -Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}  ```      在此字段中使用代码补全：开始输入标志的名称，IDE 会建议可用的命令行选项列表。 这适用于  `-XX:`  和  `-X`  选项以及一些不是由 IntelliJ IDEA 自动配置的标准选项，例如  `-ea` ，但不适用于  `-cp`  或  `–release` 。       在此字段中指定的  `-classpath`  选项会重写模块的类路径。     |
|  执行“更新”操作时  |  为 [更新应用程序](updating-applications-on-application-servers.html) 功能选择必要的选项 ( ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.refresh.svg) 或 `Ctrl+F10` (Windows), `⌘ F10` (macOS), `⌘ F10` (IntelliJ IDEA Classic (macOS)), `⌘ F10` (macOS System Shortcuts), `Ctrl+F10` (XWin), `Ctrl+F10` (GNOME), `Ctrl+F10` (KDE), `Ctrl+F10` (Emacs), `Ctrl+F10` (Sublime Text), `⌘ F10` (Sublime Text (macOS)), `Ctrl+F10` (Visual Studio), `⌘ F10` (Visual Studio (macOS)), `Ctrl+F10` (NetBeans), `Ctrl+F10` (Eclipse), `⌘ F10` (Eclipse (macOS)) 在   运行   或   调试   工具窗口中)。    已展开工件和已打包工件的更新选项不同。       对于已展开的工件，可用的选项有：        * 更新资源。 所有更改的资源都已更新（HTML、JSP、JavaScript、CSS 和图像文件）。    * 更新类和资源。 已更改的资源会被更新；更改过的 Java 类（EJB、servlet 等）会被重新编译。 在调试模式下，更新后的类会被热替换。 在运行模式中，IntelliJ IDEA 只更新输出文件夹中已更改的类。 在运行中的应用程序中，这些类是否真的被重新加载，取决于所使用的运行时的功能。    * 重新部署。 应用程序构件已重新构建并重新部署。    * 重启服务器。 服务器将重新启动。 应用程序工件将重新构建并重新部署。      对于打包的制品，可用的选项有：        * 热交换类。 更改的类会在运行时重新编译并重新加载。 此选项仅在调试模式下有效。    * 重新部署。 应用程序构件已重新构建并重新部署。    * 重启服务器。 服务器将重新启动。 应用程序工件将重新构建并重新部署。    |
|  显示对话框  |  如果希望看到   更新   对话框，并且每次使用 [更新应用程序](updating-applications-on-application-servers.html) 函数／方法时都显示，请选中此复选框。      更新   对话框用于在实际更新应用程序之前选择   更新   选项。     |
|  框架停用时  |  指定切换到不同应用程序（例如，网页浏览器）时 IntelliJ IDEA 应执行的操作。 （框架停用意味着切换到另一个应用程序。）    除此选项外，其余选项与   不执行任何操作  在   更新  操作中的含义相同。     |
|  JRE  |  默认情况下，项目 JDK 用于运行应用程序。 如果您想在此指定替代的 JDK 或 JRE，请从下拉列表中选择。  |
|  HTTP 端口  |  服务器 HTTP 端口。  |
|  HTTPS 端口  |  服务器 HTTPS 端口。  |
|  JMX 端口  |  服务器 JMX 端口。  |
|  AJP 端口  |  服务器 AJP 端口。  |
|  部署 Tomcat 实例中配置的应用程序  |  Tomcat 配置文件可能会列出应在服务器启动时部署的应用程序。 如果选中此复选框，除了   部署   选项卡上指定的工件之外，所有这些列出的应用程序都将部署到服务器上。    如果未选中此复选框，则只会部署   部署   选项卡上指定的工件和外部资源。     |
|  重启时保持会话  |  选中此复选框可在重新启动服务器时保留活动的 HTTP 会话。  |

##  远程配置的服务器选项卡 

|  条目  |  描述  |
| --- | --- |
|  应用程序服务器  |     请选择要使用的服务器配置。 请注意，这是本地服务器配置。 （在使用远程服务器时，必须在本地提供相同的服务器版本。）       点击   配置   以创建新的服务器配置或编辑现有配置。 （ [应用程序服务器对话框](application-servers-settings.html)将打开。）     |
|  在启动后  |  选中此复选框以在连接到服务器并部署工件后启动一个网页浏览器。    从列表中选择浏览器。 点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) 以配置 Web 浏览器。     |
|  使用 JavaScript 调试器  |  如果选中此复选框，Web 浏览器将以启用 JavaScript 调试器的状态启动。    请注意，JavaScript 调试仅适用于 Firefox 和 Google Chrome。 首次在 Firefox 中调试 JavaScript 时，将安装 JetBrains Firefox 扩展程序。     |
|  URL  |  指定服务器启动时浏览器应打开的 URL。 在大多数典型情况下，此 URL 对应于 Web 应用程序的根目录或起始页面。  |
|  远程暂存  |  本节包含与 [staging](http://en.wikipedia.org/wiki/Staging_site)相关的设置。  |
|  类型  |  选择用于从本地计算机传输应用程序工件的暂存环境或主机访问方式。 （在 IntelliJ IDEA 的用户界面中，此设置也称为  连接类型 。）    可用选项包括：        * 相同的文件系统。 如果目标服务器安装在您的本地计算机上，请选择此选项。 在这种情况下，构件被本地部署，因此不需要转移到远程主机。    * ftp. 使用了 [文件传输协议](http://en.wikipedia.org/wiki/File_Transfer_Protocol)或 [Secure FTP](http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol)。    * 本地或挂载文件夹。 预演环境是本地文件夹或以 [挂载文件夹](https://learn.microsoft.com/en-gb/windows/win32/fileio/volume-mount-points)的方式访问。      如果列表为空，您需要 [启用 FTP/SFTP Connectivity 插件](managing-plugins.html)，该插件支持相应的功能。     |
|  主持人  |  如果选择   相同文件系统   用于   类型  ，那么   主持人   唯一可用的选项也是   相同文件系统  。    在所有其他情况下，该列表包含所选类型的现有配置。 因此，每个配置都对应一个单独的 (S)FTP 连接，或一个本地或挂载的文件夹。       选择一个现有的配置或创建一个新的配置。       要创建一个新配置：        1.  请点击列表右侧的 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)。     2.  在 [部署对话框](settings-deployment.html)中，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)。     3.  在   添加服务器   对话框中，指定配置名称，选择类型，然后点击   OK  。     4.  在 [Connection tab](deployment-connection-tab.html)中，指定   上传/下载项目文件  部分的设置。    其余设置无关紧要。        5.  点击   OK  在   部署  对话框。     |
|  暂存  |  在部署到远程主机时，应用程序工件将被放置到一个应当可供 Tomcat 访问的临时文件夹中。 本节中的设置定义了此暂存文件夹的位置。    请注意，如果选择了   相同文件系统   用于   类型   和   主持人  ，则无需指定本节中的任何设置。     |
|  从根目录开始的路径  |  指向暂存文件夹的路径相对于本地或挂载文件夹，或 (S)FTP 主机的根目录。    您可以使用 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 在   选择目标路径   对话框中选择文件夹。     |
|  映射为  |  远程主机本地文件系统中临时文件夹的绝对路径。  |
|  远程连接设置  |  访问已部署应用程序的设置。  |
|  主持人  |  Tomcat 主机的完全限定域名或 IP 地址。  |
|  端口  |  服务器 HTTP 端口。  |

## 示例：挂载文件夹的远程暂存

假设：

* `C:\shared` 是远程主机上的共享文件夹，被挂载到本地计算机作为驱动器 `X:` 。

* 您将用于暂存的文件夹是 `C:\shared\staging` 。

以下是相应的远程暂存设置：

* 类型: 本地或挂载的文件夹。

* 主机： 应选择配置， 文件夹 字段中的值应为 `X:\` （ 连接 选项卡上 部署 对话框中的 上传/下载项目文件 部分）。

* 从根目录到 Staging 的路径： `staging`

* 预处理/映射为： `C:\shared\staging`

## 部署选项卡

指定要部署哪些 [构件](working-with-artifacts.html)或外部资源。 外部资源是可部署的 Web 组件，如  `.war` 文件，它不由项目工件表示。 通常，这类组件存储在项目范围之外。

> **Note:**
> 要将工件部署到远程应用服务器，您需要 Tomcat 版本 5 或更高版本。 请确保传递以下 VM 选项以在服务器上启用 JMX 支持：
>
>
>
>
> ```
> -Dcom.sun.management.jmxremote=
> -Dcom.sun.management.jmxremote.port=1099
> -Dcom.sun.management.jmxremote.rmi.port=1099
> -Dcom.sun.management.jmxremote.ssl=false
> -Dcom.sun.management.jmxremote.authenticate=false
> -Djava.rmi.server.hostname=127.0.0.1
>
> ```
>
>
>
> 指定您的应用服务器的端口和主机名或 IP 地址。
>
>
>
> 如果您使用  `catalina.bat`  或  `catalina.sh`  启动服务器，通过  `CATALINA_OPTS`  环境变量传递选项。

|  条目  |  描述  |
| --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 或 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |     将工件或外部资源添加到列表中。     |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 或 `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  从列表中删除选定的工件和外部资源。  |
|  ![编辑工件](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) 或 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))  |  配置已选择的构件。 [制品页面](artifacts.html) 将打开   项目结构对话框  。  |
|  应用程序上下文  |  指定工件或外部资源的 [上下文根](http://download.oracle.com/javaee/1.4/tutorial/doc/WebApp3.html)：选择工件或资源，然后键入或选择上下文根。  |

## 日志标签

使用此选项卡指定运行或调试时生成的日志文件应显示在控制台上，即 [Run](run-tool-window.html) 或 [调试工具窗口](debug-tool-window.html) 的专用选项卡上。

|  条目  |  描述  |
| --- | --- |
|    将显示在控制台中的日志文件    |  |
|    处于活动状态    |  选中此列中的复选框以在 [运行工具窗口](run-tool-window.html) 或 [调试工具窗口](debug-tool-window.html) 中显示日志条目。  |
|    日志文件条目    |     此列中的只读字段列出了要显示的日志文件。 列表可以包含：        * 特定文件的完整路径。    * [Ant 模式](http://ant.apache.org/manual/dirtasks.html#patterns)定义要显示的文件范围。    * 用于替代完整路径或模式的别名。 这些别名也显示在选项卡的标题中，对应的日志文件在其中显示。 如果日志条目模式定义了多个文件，选项卡标题将显示文件名而不是日志条目别名。    |
|    跳过内容    |  选中此复选框以跳过所选日志的先前内容。  |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  点击此按钮以打开 [编辑日志文件别名对话框](null)，在此对话框中您可以选择一个新的日志条目并为其指定别名。  |
|  ![编辑按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  点击此按钮以在 [编辑日志文件别名对话框](null)中编辑所选日志文件条目的属性。  |
|  ![删除按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  点击此按钮从列表中删除所选日志条目。  |
|    将控制台输出保存到文件    |  选择此复选框以将控制台输出保存到指定位置。 请手动输入路径，或点击浏览按钮并指向 [打开的对话框](null)中的所需位置。  |
|    在消息打印到标准输出流时显示控制台    |  选中此复选框以激活输出控制台，并在关联进程写入 Standard.out 时将其前置。  |
|    在消息打印到标准错误流时显示控制台    |  选中此复选框以激活输出控制台，并在相关进程写入 Standard.err 时将其置于前端。  |

## 代码覆盖率选项卡

使用此选项卡配置 [代码覆盖率](code-coverage.html)监控选项。

请注意，此选项卡不适用于远程服务器。

|  条目  |  描述  |
| --- | --- |
|  选择代码覆盖率运行器  |  选择所需的代码覆盖率运行器。  |
|  抽样  |  选择此选项以在最小化运行减速的情况下测量代码覆盖率。  |
|  跟踪  |  选择此选项以收集准确的分支覆盖率。 此模式仅适用于 IntelliJ IDEA 代码覆盖运行器。  |
|  按测试覆盖率跟踪  |  选中此复选框以检测由一个测试覆盖的行和所有覆盖该行的测试。  |
|  用于记录代码覆盖率数据的软件包和类  |     如果必要，请指定要测量的类和包。       使用 ![添加类按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolbarDecorator.addClass.svg) 或 !["添加软件包"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolbarDecorator.addFolder.svg) 将类或包添加到列表中。       要从列表中移除类或包，请选择相应的列表项并点击 !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。     |
|  在测试文件夹中启用覆盖率。  |  选中此复选框以在代码覆盖率分析中包含测试源文件夹。  |

## 本地配置的启动/连接选项卡

|  条目  |  描述  |
| --- | --- |
|     ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 运行 /       ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) 调试 /       ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg) 覆盖率     |  用于在运行、调试和代码覆盖模式的设置之间切换。  |
|  启动脚本  |  指定用于启动服务器的脚本。      使用默认：          * 如果选中此复选框，将使用默认脚本。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg) 在这种情况下将打开 默认启动脚本 对话框，其中显示 启动脚本 字段的内容（只读）。    * 取消选中此复选框以更改传递给脚本的参数或指定不同的脚本： * 要指定脚本，请点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后在 [打开的对话框](null) 中选择所需脚本。 * 要指定形参，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg)，然后在 配置 VM 和程序参数 对话框中指定脚本形参和虚拟机选项。 指定形参和选项时，请遵循以下规则： * 请使用空格分隔各个参数和选项，例如， `-client -ea -Xmx1024m` 。 * 如果形参或选项包含空格，请用双引号将空格或包含空格的实参括起来，例如 `some" "arg` 或 `"some arg"` 。 * 如果形参或选项包含双引号（例如作为实参的一部分），请使用反斜杠转义双引号，例如 `-Dmy.prop=\"quoted_value\"` 。    |
|  关机脚本  |  指定用于停止服务器的脚本。      使用默认：          * 如果选中此复选框，将使用默认脚本。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg) 在这种情况下将打开 默认关机脚本 对话框，其中显示 关机脚本 字段的内容（只读）。    * 取消选中此复选框以更改传递给脚本的参数或指定不同的脚本： * 要指定脚本，请点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后在 [打开的对话框](null) 中选择所需脚本。 * 要指定形参，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg)，然后在 配置 VM 和程序参数 对话框中指定脚本形参和虚拟机选项。 指定形参和选项时，请遵循以下规则： * 请使用空格分隔各个参数和选项，例如， `-client -ea -Xmx1024m` 。 * 如果形参或选项包含空格，请用双引号将空格或包含空格的实参括起来，例如 `some" "arg` 或 `"some arg"` 。 * 如果形参或选项包含双引号（例如作为实参的一部分），请使用反斜杠转义双引号，例如 `-Dmy.prop=\"quoted_value\"` 。    |
|  传递环境变量  |  要将特定变量传递给服务器环境，请选中此复选框并指定变量：     * 要添加变量，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，然后分别在 名称 和 值 字段中指定变量名称和值。    * 要从列表中移除变量，请选择该变量并点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。    |
|  端口  |  请使用此字段更改调试器端口。  |
|  调试器设置  |  点击此按钮以在 [调试器页面](settings-debugger.html)的 [设置对话框](settings-preferences-dialog.html)中编辑调试器选项。  |

## 远程配置的 Startup/Connection 标签

此选项卡显示在运行和调试模式下启动服务器 JVM 的命令行选项。

|  条目  |  描述  |
| --- | --- |
|     ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.toolwindows.toolWindowRun.svg) 运行 /       ![](https://resources.jetbrains.com/help/img/idea/2026.3/workspace.xml` 。     |

## 启动前

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

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |     点击此图标以添加以下可用任务之一：        * 启动 Web 浏览器‍™™™™™™™‍ ：选择此选项以启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 此外，指定是否希望浏览器与 JavaScript 调试器一起启动。    * 运行外部工具 ：选择运行外部应用。 在打开的对话框中，选择您想要运行的一个或多个应用程序。 如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。 如需更多信息，请参阅 [外部工具](configuring-third-party-tools.html) 和 [外部工具设置](settings-tools-external-tools.html)。    * 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。 如果您想并行运行多个配置，请使用 [compound run/debug configuration](run-debug-multiple.html#compound-configs)。    * 构建 ：选择编译指定的模块。 [Build Module命令](compiling-applications.html#compile_module) 将会被执行。 如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。    * 构建项目 ：选择编译整个项目。 [Build Project 命令](compiling-applications.html#compile_module) 将被执行。 如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。    * 构建，不进行错误检查 ：与 构建 选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。    * 构建制品 ：选择此选项以构建一个或多个 [构件](working-with-artifacts.html)。 在打开的对话框中，选择应构建的 artifact。    * 运行远程外部工具 ：添加一个 [远程 SSH 外部工具](settings-tools-remote-ssh-external-tools.html)。    * 运行 Grunt 任务 ：选择此选项以运行 Grunt 任务。 在打开的 Grunt 任务 对话框中，指定定义所需任务的 `Gruntfile.js` ，选择要执行的任务，并指定传递给 Grunt 工具的参数。 指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。    * 运行 Gulp 任务 ：选择此选项以运行 Gulp 任务。 在打开的 Gulp 任务 对话框中，请指定定义所需任务的 `Gulpfile.js` ，选择要执行的任务，并指定传递给 Gulp 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。    * 运行 Maven 目标 ：选择此选项以 [运行一个 Maven 目标](work-with-maven-goals.html)。 在打开的对话框中，选择要运行的目标。    * 运行 npm 脚本 ：选择此选项以执行 npm script。 在打开的 npm 脚本 对话框中，指定 [npm 运行/调试配置设置](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除 检查错误 复选框，以配置在检测到任何错误时编译器的行为： * 如果选中 检查错误 复选框，编译器将显示所有错误，运行配置将不会启动。 * 如果取消选中 检查错误 复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。    * 断开数据源 ：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。    |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  点击此图标以从列表中删除所选任务。  |
|  ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))  |  点击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。  |
|     ![方法 up](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg)       ![方法 down](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg)     |     `Alt+Up` (Windows), `⌃ ⇧ ↑` (macOS), `⌃ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `Alt+Up` (Sublime Text (macOS)), `Alt+Up` (Visual Studio), `⌃ ⇧ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Shift+Up` (Eclipse), `⌃ ⌥ ↑` (Eclipse (macOS))       `Alt+Down` (Windows), `⌃ ⇧ ↓` (macOS), `⌃ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `Alt+Down` (Sublime Text (macOS)), `Alt+Down` (Visual Studio), `⌃ ⇧ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Shift+Down` (Eclipse), `⌃ ⌥ ↓` (Eclipse (macOS))     |  点击这些图标可以将所选任务在列表中上下移动一行。 任务按照它们在列表中出现的顺序执行。  |
|  显示此页面  |  |  选中此复选框，以在实际启动运行/调试配置之前显示运行/调试配置设置。  |
|  激活工具窗口  |  |     默认情况下，将选中此复选框，启动运行/调试配置时将打开 [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口。       否则，如果复选框被清除，工具窗口将被隐藏。 但是，当配置运行时，您可以通过按 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) 自行打开相应的工具窗口。     |
|  使工具窗口获得焦点  |  |     选中此复选框可在启动运行/调试配置时，自动将焦点移动到 [Run](run-tool-window.html)或 [Debug](debug-tool-window.html)工具窗口。     |

## 日志

以下选项与记录此配置的执行相关。 有关更多信息，请参见 [日志](setting-log-options.html)。

|  条目  |  描述  |
| --- | --- |
|     指定要在控制台中显示的日志     |     指定在运行应用程序时显示哪些日志文件。       点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 添加新日志。 在   编辑日志文件别名  对话框中，配置以下内容：        * 别名 ：日志将显示的选项卡名称。    * 日志文件位置 ：指定日志文件的路径或 [Ant 模式](https://ant.apache.org/manual/dirtasks.html)。 如果多个滚动日志文件匹配该模式，IntelliJ IDEA 将显示最新的一个。    * 显示所有可由模式匹配的文件 ：显示所有匹配该模式的日志。      对于表中的日志，您可以配置以下选项：        * 处于活动状态 ：显示指定的日志文件。    * 跳过内容 ：不显示先前运行的旧日志消息。    |
|     将控制台输出保存到文件     |  将控制台输出保存到指定位置。 手动输入路径，或点击浏览按钮，然后在 [打开的对话框](null) 中指向所需位置。  |
|     在消息打印到标准输出时显示控制台​​絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍絠絍灾遇崶俶殊糇娘藏瘟殛面勺察揽慄馨湮斜烁磐彦箴腓蘖衮褚觎锲鸵,     |  当应用程序写入标准输出流时激活控制台。  |
|     在消息打印到标准错误流时显示控制台     |  当应用程序写入标准错误流时激活控制台。  |

## See also

### 概念

[运行/调试配置](run-debug-configuration.html)

### 参考

[调试器设置](settings-debugger.html)