# 启用 Web 应用程序支持

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

> **TL;DR**
> 所需插件： [Jakarta EE：持久性（JPA）](https://plugins.jetbrains.com/plugin/20202)（已捆绑）、 [Jakarta EE：Web/Servlets](https://plugins.jetbrains.com/plugin/20216)（已捆绑）、以及 [Jakarta EE：Enterprise Java Beans（EJB）](https://plugins.jetbrains.com/plugin/16939)（未捆绑）

启用 IntelliJ IDEA 中的   Web 应用程序  支持后，您可以执行以下操作：

* 创建一个网络资源目录 `web` ，其中包含 `index.jsp` 作为应用程序的起始页，并可选地包含一个网络应用 [部署描述符](https://en.wikipedia.org/wiki/Deployment_descriptor) `WEB-INF/web.xml` 。

* 创建一个 Web facet，允许您管理部署描述符、web 资源目录和您的 Java web [source roots](null)。

* 创建一个分解的 [WAR](https://en.wikipedia.org/wiki/WAR_(file_format)) [artifact](working-with-artifacts.html) 配置。

* 提供对 [Web](web-tool-window.html)工具窗口的访问权限。

如果您在创建项目或模块时启用了   Web 应用程序   支持并指定了应用程序服务器，IntelliJ IDEA 还会为该服务器创建一个 [运行/调试配置](creating-run-debug-configuration-for-application-server.html)。

Procedure: 创建一个使用 Servlet 的新 Jakarta EE 项目

1. 打开   新建项目  向导：

* 如果位于主屏幕，请选择 `![加号](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.general.add.svg) 新建 | ![文件夹图标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.platform.icons.expui.nodes.folder.svg) 项目……` 。

* 如果已打开另一个项目，请转到 `文件 | 新建 | 项目` 。

2. 从左侧的   生成器   列表中，选择 ![Jakarta EE 徽标](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.java.ultimate.icons.icons.javaee.newui.jakartaEE.svg)   Jakarta EE  。

![Jakarta EE 项目向导的第一步](https://resources.jetbrains.com/help/img/idea/2026.3/jakarta_new_project_step_1_web.png)

3. 选择   Web 应用程序   模板，并设置其余的 [Jakarta EE 项目设置](new-project-wizard.html#java-ee)。

准备就绪后，点击   下一步  。

4. 从   版本   下拉菜单中选择要使用的 Jakarta EE 版本。

5. （可选）从   依赖项   列表中，选择要包含在项目中的其他规范或实现。 由于使用了 web 应用程序模板，已选择   Servlet   规范。

6. 点击   创建  。

有关创建 Jakarta EE 项目的更多信息，例如如何设置应用程序服务器，请参阅 [教程：您的第一个 Jakarta EE 应用程序](creating-and-running-your-first-jakarta-ee-application.html)。

Procedure: 将 Web 应用支持添加到现有模块

> **Note:**
> 此信息适用于使用原生 IntelliJ IDEA 构建器构建的项目。 如果您正在使用构建工具，例如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，请使用构建文件进行所有更改。

1. 在   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，选择所需的模块。

2. 按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) 并输入  `Add Framework Support` 。

一旦找到操作，点击它以打开   Add Framework Support  对话框。

3. 在打开的对话框中，选择   Web 应用程序  ，并选择一个 Servlet 规范版本。

4. 如果希望创建部署描述符  `web.xml`  文件，请选中  `Create web.xml`  复选框。

点击   OK  。

![添加对框架的支持](https://resources.jetbrains.com/help/img/idea/2026.3/ij_add_framework_support.png)

Procedure: 管理 Web 应用程序设置

您可以在   项目结构  对话框中管理您的 web 应用 [部署描述符](https://en.wikipedia.org/wiki/Deployment_descriptor)、web 资源目录和 Java web [源根](null)。

1. 在主菜单中，转到  `文件 | 项目结构`  或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))。

2. 在左侧窗格中，选择   模块  或   Facet  。

3. 选择   Web   facet。

4. 配置以下内容：

部署描述符
: 应用程序部署描述符列表

Web 资源目录
: 包含您的网页应用资源的目录，例如网页和图像

源根
: 源根包含您的 Web 应用程序 Java 类，例如 servlets、filters 和 managed beans。

有关更多信息，请参见 [Web facet 页](web-facet-page.html)。

## 管理应用程序制品

要管理您的 artifact 配置，请使用   项目结构   对话框 (  `文件 | 项目结构 | 构件` )。

要将您的应用程序部署到服务器，您需要一个应用程序 [artifact](working-with-artifacts.html)。 对于 Java web 应用程序，IntelliJ IDEA 提供以下工件格式：

* Web 应用程序：已解压。 这是一个解压缩的 Web 应用程序归档（ [WAR](https://en.wikipedia.org/wiki/WAR_(file_format))），一种可部署到 Web 服务器的目录结构。

* Web 应用程序：归档。 这是一个 WAR 文件。

有关更多信息，请参见 [构件](working-with-artifacts.html)。

## See also

### 过程

[Developing a Jakarta EE Web Application](creating-and-running-your-first-jakarta-ee-application.html) [应用程序服务器](application-servers-support.html)

### 参考

[Web facet 页](web-facet-page.html)