IntelliJ IDEA 2025.1 Help

运行/调试配置:Tomcat 服务器

请使用 Tomcat 服务器 run/debug configuration来部署并调试您的应用程序在 Tomcat上。 如需更多信息,请参阅 应用服务器运行配置

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

  • 请使用 远程 配置将构件部署到正在运行的应用服务器实例。

启用 Tomcat 和 TomEE 插件

此功能依赖于 Tomcat 和 TomEE 插件,该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 已安装 选项卡,找到 Tomcat 和 TomEE插件,勾选插件名称旁边的复选框。

本地配置的 服务器 选项卡

条目

描述

应用程序服务器

请选择要使用的服务器配置。

点击 配置 创建新的服务器配置或编辑现有的配置。 (应用服务器对话框 将会打开。)

在启动后

选中此复选框以在启动服务器并部署工件后启动一个网页浏览器。

从列表中选择浏览器。 请点击 浏览按钮 Shift+Enter 配置您的网页浏览器。

使用 JavaScript 调试器

如果选中此复选框,网页浏览器将会在启用 JavaScript 调试器的情况下启动。

请注意,JavaScript 调试只适用于 Firefox 和 Google Chrome。 当您第一次在 Firefox 中调试 JavaScript 时,会安装 JetBrains Firefox extension。

URL

指定服务器启动时浏览器应打开的 URL。 在大多数典型情况下,该 URL 对应于您的 Web 应用程序的根目录或其起始页面。

虚拟机选项(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 选项将覆盖模块的 classpath。

执行“更新”操作时

更新应用程序 功能选择必要的选项 (Ctrl+F10运行调试 工具窗口中)。

更新选项对于 exploded 和 packed 工件 是不同的。

对于已展开的工件,可用的选项有:

  • 更新资源. 所有更改的资源都已更新(HTML、JSP、JavaScript、CSS 和图像文件)。

  • 更新类和资源. 已更改的资源会被更新;更改过的 Java 类(EJB、servlet 等)会被重新编译。

    在调试模式下,更新后的类会被热替换。 在运行模式中,IntelliJ IDEA 只更新输出文件夹中已更改的类。 在运行中的应用程序中,这些类是否真的被重新加载,取决于所使用的运行时的功能。

  • 重新部署. 应用程序构件已重新构建并重新部署。

  • 重启服务器. 服务器已重新启动。 应用程序 artifact 已重新构建并重新部署。

对于打包的制品,可用的选项有:

  • 热交换类。 更改的类会在运行时重新编译并重新加载。 此选项仅在调试模式下有效。

  • 重新部署. 应用程序构件已重新构建并重新部署。

  • 重启服务器. 服务器已重新启动。 应用程序 artifact 已重新构建并重新部署。

显示对话框

如果您希望每次使用 更新应用程序功能时都看到 更新 对话框,请选中此复选框。

更新 对话框用于在实际更新应用程序之前选择 更新 选项。

切换出 IDE 时

指定切换到不同应用程序(例如,网页浏览器)时 IntelliJ IDEA 应执行的操作。 (框架停用意味着切换到另一个应用程序。)

除此选项外,其余选项与 什么都不做更新 操作中的含义相同。

JRE

默认情况下,项目 JDK 用于运行应用程序。 如果您想在此指定替代的 JDK 或 JRE,请从下拉列表中选择。

HTTP 端口

服务器 HTTP 端口。

HTTPS 端口

服务器 HTTPS 端口。

JMX 端口

服务器 JMX 端口。

AJP 端口

服务器 AJP 端口。

部署 Tomcat 实例中配置的应用程序

Tomcat 配置文件可能会列出应在服务器启动时部署的应用程序。 如果选择此复选框,所有列出的应用程序将与 部署 选项卡中指定的工件一起部署到服务器。

如果未选中该复选框,则只会部署 部署 选项卡上指定的工件和外部资源。

重启时保持会话

选中此复选框以在重启服务器时保留活动的 HTTP 会话。

远程配置的 服务器 标签

条目

描述

应用程序服务器

请选择要使用的服务器配置。 请注意,这是本地服务器配置。 (在使用远程服务器时,必须在本地提供相同的服务器版本。)

点击 配置 创建新的服务器配置或编辑现有的配置。 (应用服务器对话框 将会打开。)

在启动后

选中此复选框以在连接到服务器并部署工件后启动一个网页浏览器。

从列表中选择浏览器。 请点击 浏览按钮 Shift+Enter 配置您的网页浏览器。

使用 JavaScript 调试器

如果选中此复选框,网页浏览器将会在启用 JavaScript 调试器的情况下启动。

请注意,JavaScript 调试只适用于 Firefox 和 Google Chrome。 当您第一次在 Firefox 中调试 JavaScript 时,会安装 JetBrains Firefox extension。

URL

指定服务器启动时浏览器应打开的 URL。 在大多数典型情况下,该 URL 对应于您的 Web 应用程序的根目录或其起始页面。

远程暂存

本节包含与 staging相关的设置。

类型

选择用于从本地计算机传输应用程序工件的暂存环境或主机访问方式。 (在 IntelliJ IDEA 的用户界面中,此设置也称为 连接类型。)

可用选项包括:

  • 相同的文件系统。 如果目标服务器安装在您的本地计算机上,请选择此选项。 在这种情况下,构件被本地部署,因此不需要转移到远程主机。

  • ftp. 使用了 文件传输协议Secure FTP

  • 本地或挂载文件夹。 预演环境是本地文件夹或以 挂载文件夹的方式访问。

如果列表为空,您需要 启用 FTP/SFTP Connectivity 插件 ,该插件支持相应的功能。

主持人

如果选择 相同文件系统 用于 类型 ,那么 主持人 唯一可用的选项也是 相同文件系统

在所有其他情况下,该列表包含所选类型的现有配置。 因此,每个配置都对应一个单独的 (S)FTP 连接,或一个本地或挂载的文件夹。

选择一个现有的配置或创建一个新的配置。

要创建一个新配置:

  1. 请点击列表右侧的 浏览按钮

  2. 部署对话框中,点击

  3. 添加服务器 对话框中,指定配置名称,选择类型,然后点击 OK

  4. Connection tab中,指定 上传/下载项目文件 部分的设置。

    其余设置无关紧要。

  5. 点击 OK部署 对话框。

暂存

在部署到远程主机时,应用程序工件将被放置到一个应当可供 Tomcat 访问的临时文件夹中。 本节中的设置定义了此暂存文件夹的位置。

请注意,如果选择了 相同文件系统 用于 类型主持人 ,则无需指定本节中的任何设置。

从根目录开始的路径

指向暂存文件夹的路径相对于本地或挂载文件夹,或 (S)FTP 主机的根目录。

您可以使用 浏览按钮选择目标路径 对话框中选择文件夹。

映射为

远程主机本地文件系统中临时文件夹的绝对路径。

远程连接设置

访问已部署应用程序的设置。

主持人

Tomcat 主机的完全限定域名或 IP 地址。

端口

服务器 HTTP 端口。

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

假设:

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

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

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

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

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

  • 从根目录到 Staging 的路径: 暂存

  • 预处理/映射为: C:\shared\staging

部署选项卡

指定要部署哪些 构件或外部资源。 外部资源是可部署的 Web 组件,如 .war 文件,它不由项目工件表示。 通常,这类组件存储在项目范围之外。

条目

描述

"添加"按钮Alt+Insert

将工件或外部资源添加到列表中。

"移除"按钮Alt+Delete

从列表中删除选定的工件和外部资源。

编辑工件F4

配置已选择的构件。 制品页面 将打开 项目结构对话框

应用程序上下文

请为工件或外部资源指定 context root :选择工件或资源,然后输入或选择context root。

日志标签

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

条目

描述

处于活动状态

选中此列中的复选框以在 运行工具窗口Debug(调试)工具窗口 中显示日志条目。

日志文件条目

此列中的只读字段列出了要显示的日志文件。 列表可以包含:

  • 特定文件的完整路径。

  • Ant 模式定义要显示的文件范围。

  • 用于替代完整路径或模式的别名。 这些别名也显示在选项卡的标题中,对应的日志文件在其中显示。

    如果日志条目模式定义了多个文件,选项卡标题将显示文件名而不是日志条目别名。

跳过内容

选中此复选框以跳过所选日志的先前内容。

将控制台输出保存到文件

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

在消息打印到标准输出流时显示控制台

选中此复选框以激活输出控制台,并在关联进程写入 Standard.out 时将其前置。

在消息打印到标准错误流时显示控制台

选中此复选框以激活输出控制台,并在相关进程写入 Standard.err 时将其置于前端。

"添加"按钮

点击此按钮以打开 编辑日志文件别名对话框 ,在此对话框中您可以选择一个新的日志条目并为其指定别名。

编辑按钮

点击此按钮以在 编辑日志文件别名对话框中编辑所选日志文件条目的属性。

删除按钮

点击此按钮从列表中删除所选日志条目。

代码覆盖率选项卡

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

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

条目

描述

选择代码覆盖率运行器

选择所需的代码覆盖率运行器。

抽样

选择此选项以在最小化运行减速的情况下测量代码覆盖率。

跟踪

选择此选项以收集准确的分支覆盖率。 此模式仅适用于 IntelliJ IDEA 代码覆盖运行器。

按测试覆盖率跟踪

选中此复选框以检测由一个测试覆盖的行和所有覆盖该行的测试。

记录代码覆盖率数据的软件包和类

如果必要,请指定要测量的类和包。

使用 添加类按钮“ 添加包按钮 ” 将类或包添加到列表中。

要从列表中移除类或包,请选择相应的列表项并点击 "移除"按钮

在测试文件夹中启用覆盖率。

选中此复选框以在代码覆盖率分析中包含测试源文件夹。

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

条目

描述

 运行 /

 调试 /

 覆盖率

用于在运行、调试和代码覆盖模式的设置之间切换。

启动脚本

指定用于启动服务器的脚本。

使用默认:

  • 如果选中此复选框,将使用默认脚本。

     此情况下会打开 默认启动脚本 对话框,这个对话框显示 启动脚本 字段的内容(只读)。

  • 取消选中此复选框以更改传递给脚本的参数或指定不同的脚本:

    • 要指定脚本,请点击 浏览按钮 并在 打开的对话框中选择所需的脚本。

    • 要指定参数,请点击 并在 配置 VM 和程序参数 对话框中指定脚本参数和 VM 选项。

      在指定参数和选项时,请遵循以下规则:

      • 请使用空格分隔各个参数和选项,例如, -client -ea -Xmx1024m

      • 如果参数或选项包含空格,请将空格或包含空格的参数用双引号括起来,例如, some" "arg"some arg"

      • 如果一个参数或选项包含双引号(例如,作为参数的一部分),请通过反斜杠转义双引号,例如, -Dmy.prop=\"quoted_value\"

关机脚本

指定用于停止服务器的脚本。

使用默认:

  • 如果选中此复选框,将使用默认脚本。

     此情况下会打开 默认关机脚本 对话框,这个对话框显示 关机脚本 字段的内容(只读)。

  • 取消选中此复选框以更改传递给脚本的参数或指定不同的脚本:

    • 要指定脚本,请点击 浏览按钮 并在 打开的对话框中选择所需的脚本。

    • 要指定参数,请点击 并在 配置 VM 和程序参数 对话框中指定脚本参数和 VM 选项。

      在指定参数和选项时,请遵循以下规则:

      • 请使用空格分隔各个参数和选项,例如, -client -ea -Xmx1024m

      • 如果参数或选项包含空格,请将空格或包含空格的参数用双引号括起来,例如, some" "arg"some arg"

      • 如果一个参数或选项包含双引号(例如,作为参数的一部分),请通过反斜杠转义双引号,例如, -Dmy.prop=\"quoted_value\"

传递环境变量

要将特定变量传递到服务器环境,请选择此复选框并指定变量:

  • 要添加变量,请点击 ,并分别在 名称 字段中指定变量名称和值。

  • 要从列表中删除变量,请选择该变量并点击

端口

请使用此字段更改调试器端口。

调试器设置

点击此按钮以在 调试器页面设置对话框中编辑调试器选项。

远程配置的 Startup/Connection 标签

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

条目

描述

 运行 /

 调试

用于在运行模式和调试模式的设置之间切换。 设置显示在 要运行/调试... 下方区域。

要运行/调试远程服务器 JVM...

启动服务器 JVM 的命令行选项。 这些仅用于复制到其他地方。

传输(及其所有内容)

用于生成远程调试命令行选项的 GUI 显示在 要运行/调试... 下方的区域

通用设置

当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

条目

描述

名称(N)

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

允许多个实例(U)

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

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

存储为项目文件(S)

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

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

工具栏

运行/调试配置的树状视图包含一个工具栏,可帮助您管理 项目 中可用的配置以及调整默认配置模板。

条目

快捷键

描述

"添加"按钮

Alt+Insert

创建运行/调试配置。

"移除"按钮

Alt+Delete

删除所选的运行/调试配置。 请注意,您不能删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。 请注意,您正在创建默认配置的副本。

保存配置

只有当您选择了 temporary configuration时,按钮才会显示。 点击此按钮将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。 您可以通过 将它们放入文件夹来分组运行/调试配置。

要创建文件夹,请选择类别中的配置,点击 文件夹 ,并指定文件夹名称。 如果只有一个类别处于焦点,则会创建一个空文件夹。

然后,若要将配置移动到文件夹中、文件夹之间或从文件夹中移出,请使用拖放或 上移下移 按钮。

要取消分组,请选择一个文件夹并点击 移除配置

排序配置

点击此按钮以按字母顺序排列配置。

启动前

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

条目

快捷键

描述

"添加"按钮

Alt+Insert

点击此图标以添加以下可用任务之一:

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

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

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

  • 构建 :选择编译指定的模块。 Build Module命令 将会被执行。

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

  • 构建项目 :选择编译整个项目。 Build Project 命令 将被执行。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

"移除"按钮

Alt+Delete

点击此图标以从列表中删除所选任务。

编辑

Enter

点击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。

方法 up

方法 down

Alt+Up

Alt+Down

点击这些图标可以将所选任务在列表中上下移动一行。 任务按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框,以在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,将选中此复选框,启动运行/调试配置时将打开 RunDebug 工具窗口。

否则,如果复选框被清除,工具窗口将被隐藏。 但是,当配置运行时,您可以通过按 Alt+4Alt+5 自行打开相应的工具窗口。

最后修改日期: 2025年 4月 24日