Java Web 开发环境搭建：IDEA 与 Tomcat 安装部署指南

在 Java Web 开发中，IDEA 作为主流的集成开发工具，搭配 Tomcat 轻量级 Web 服务器是入门首选。本文将基于 Java Web 基础开发要求，从 JDK 环境配置、Tomcat 安装配置、IDEA 安装、Web 项目创建，到 Tomcat 在 IDEA 中的部署运行，进行详细讲解。

一、前置准备：JDK 环境配置

Java Web 开发的核心基础是 JDK，Tomcat 和 IDEA 的运行都依赖 JDK 环境，需先完成 JDK 的安装与环境变量配置。

1. 下载与安装 JDK

前往 Oracle 官网或 OpenJDK 官网下载对应系统（本文以 Windows 10 64 位为例）的 JDK 安装包，本文使用 JDK 24 版本，双击安装包按默认步骤完成安装，记住安装路径（示例：C:\Program Files\Java\jdk-24）。

2. 配置 JDK 系统环境变量

右键此电脑→属性→高级系统设置→环境变量，进入环境变量配置界面。
新建用户变量：
- 变量名：JAVA_HOME
- 变量值：JDK 的安装根路径（示例：C:\Program Files\Java\jdk-24），点击确定。
编辑 Path 变量：
- 在用户变量的Path中点击新建，输入 %JAVA_HOME%\bin，将其上移至顶部，点击确定保存。
验证配置：按下 Win+R 输入 cmd 打开命令行，输入 java -version 和 javac -version，若显示 JDK 版本信息，说明配置成功。

二、Tomcat 服务器安装与环境配置

Tomcat 是开源的轻量级 Web 应用服务器，专为 Java Web 开发设计，支持 JSP 和 Servlet 运行，本文使用 Tomcat 9.0.115 版本。

1. 下载 Tomcat

前往 Apache Tomcat 官网（https://tomcat.apache.org/）下载 Windows 64 位压缩包，解压到指定目录（示例：D:\java web\apache-tomcat-9.0.115-windows-x64\apache-tomcat-9.0.115），解压路径不要包含中文和空格。

2. 配置 Tomcat 环境变量

再次打开环境变量界面，新建用户变量：
- 变量名：CATALINA_HOME
- 变量值：Tomcat 的解压根路径（示例：D:\java web\apache-tomcat-9.0.115-windows-x64\apache-tomcat-9.0.115），点击确定。
编辑 Path 变量：在 Path 中新建，输入 %CATALINA_HOME%\bin，点击确定保存。

3. 验证 Tomcat 安装

打开 Tomcat 解压目录下的 bin 文件夹，双击 startup.bat 启动 Tomcat 服务器，会弹出黑窗口（不要关闭）。
打开浏览器，输入 http://localhost:8080，若出现 Tomcat 默认首页，说明 Tomcat 启动成功。
关闭 Tomcat：双击 bin 文件夹下的 shutdown.bat 即可。

4. Tomcat 基础修改（可选）

修改监听端口：若 8080 端口被占用，打开 Tomcat 解压目录下的 conf\server.xml，找到 <Connector port="8080" protocol="HTTP/1.1"，将 8080 修改为未被占用的端口（如 8081），保存后重启 Tomcat 即可。
Tomcat 目录结构：核心目录包括 bin（启动 / 关闭脚本）、conf（配置文件）、webapps（项目部署目录）、logs（日志文件）、webapps（默认项目存放路径）。

三、IDEA 安装与 Web 项目创建

IntelliJ IDEA 是 Java 开发的高效集成工具，分为社区版（免费）和旗舰版（付费，有试用），Java Web 开发建议使用旗舰版（支持 Servlet、JSP、Tomcat 集成）。

1. IDEA 下载与安装

前往 JetBrains 官网（https://www.jetbrains.com/idea/）下载 IDEA 旗舰版 / 社区版安装包。
双击安装包，按以下步骤安装：
- 同意协议，点击Next；
- 选择安装路径（不要含中文 / 空格），点击Next；
- 勾选64-bit launcher、Add launchers to PATH、Associate .java files，点击Next；
- 选择默认启动界面，点击Install完成安装。
安装完成后，打开 IDEA，按提示完成激活（社区版直接使用，旗舰版可试用或激活）。

2. 在 IDEA 中创建 Java Web 项目

IDEA 创建 Web 项目有两种方式：直接创建 Web 项目、为普通 Java 项目添加 Web 支持，本文讲解为普通项目添加 Web 支持（更灵活），步骤如下：

打开 IDEA，点击New Project，选择Java，配置已安装的 JDK（IDEA 会自动识别 JAVA_HOME 中的 JDK），取消Create from template，点击Next。
输入项目名称（示例：javaweb_demo），选择项目保存路径（无中文 / 空格），点击Finish创建普通 Java 项目。
为项目添加 Web 支持：
- 右键项目根目录→Add Framework Support；
- 在弹出的窗口中，勾选Web Application，勾选Create web.xml（生成 Web 核心配置文件），点击OK；
- 项目目录中会自动生成 web 目录，包含 WEB-INF 和 index.jsp 默认页面，至此 Web 项目创建完成。

3. 编辑 JSP 页面（基础操作）

创建完 Web 项目后，可直接修改默认的 index.jsp，或新建 JSP 页面（如 cainiao.jsp）：

右键 web 目录→New→JSP/JSPX，输入文件名（如 cainiao），点击OK。
在 JSP 页面中编写 HTML+JSP 代码，示例：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Java Web 入门</title>
</head>
<body>
    <h1>Hello Java Web！</h1>
    <p>IDEA+Tomcat 部署成功</p>
</body>
</html>

四、IDEA 中配置 Tomcat 并部署 Web 项目

这是核心步骤，配置完成后即可在 IDEA 中直接启动 Tomcat 并运行 Web 项目，无需手动操作 Tomcat 的 startup.bat。

1. 配置 Tomcat 服务器

点击 IDEA 右上角的Add Configuration（或下拉框中的Edit Configurations），进入运行配置界面。
点击左上角 + 号，找到Tomcat Server→Local，创建本地 Tomcat 配置。
在弹出的界面中，配置Application server：
- 点击Configure，选择 Tomcat 的解压根路径（示例：D:\java web\apache-tomcat-9.0.115-windows-x64\apache-tomcat-9.0.115），IDEA 会自动识别 Tomcat 版本，点击OK。
配置服务器基础信息：
- Name：可自定义（如 Tomcat9）；
- HTTP port：与 Tomcat 配置的端口一致（默认 8080，若修改过则填对应端口）；
- 勾选After launch（启动后自动打开浏览器），点击Deployment选项卡。

2. 部署 Web 项目到 Tomcat

在Deployment选项卡中，点击左上角 + 号，选择Artifact→项目名:war exploded（开发环境首选，热部署更方便），点击OK。
配置Application context（项目上下文路径）：
- 默认为 /项目名（示例：/javaweb_demo），可简化为 /（直接通过 localhost:8080 访问）；
- Startup page（启动页面）：可选择默认的 index.jsp，或自定义为自己编写的页面（如 cainiao.jsp），输入 /cainiao.jsp 即可。
点击Apply→OK，完成 Tomcat 与项目的部署配置。

3. 启动 Tomcat 并运行 Web 项目

点击 IDEA 右上角的Run（绿色三角）或Debug（绿色小虫子，调试模式），启动 Tomcat 服务器。
启动成功后，IDEA 控制台会显示 Server startup in XXX ms，同时会自动打开浏览器，访问配置的启动页面（如 http://localhost:8080/javaweb_demo/cainiao.jsp）。
若需修改代码，直接在 IDEA 中编辑后，点击Build Project（Ctrl+F9），刷新浏览器即可看到修改效果（热部署）。

4. 常见问题解决：启动默认打开 index.jsp 而非自定义页面

若配置后启动仍默认打开 index.jsp，而非自己编写的 cainiao.jsp，有 3 种解决方法，按需选择：

方法 1：修改 IDEA 的 Tomcat 启动页面（最直接）

回到Edit Configurations→Deployment，将Startup page改为自定义页面路径（如 /cainiao.jsp），保存后重启 Tomcat。

方法 2：修改 web.xml 配置欢迎页面

在项目的 WEB-INF 目录下找到 web.xml，添加欢迎页面列表配置，将自定义页面设为优先，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0">
    <!-- 配置欢迎页面 -->
    <welcome-file-list>
        <welcome-file>cainiao.jsp</welcome-file> <!-- 优先访问 -->
        <welcome-file>index.jsp</welcome-file> <!-- 备用 -->
    </welcome-file-list>
</web-app>

保存后重启 Tomcat，访问项目根路径即可自动打开 cainiao.jsp。

方法 3：浏览器手动访问自定义页面

Tomcat 启动后，在浏览器地址栏输入完整访问路径：http://localhost:8080/项目上下文路径/自定义页面.jsp（示例：http://localhost:8080/javaweb_demo/cainiao.jsp），直接访问。

五、Tomcat 手动部署项目（补充）

除了在 IDEA 中集成部署，也可手动将 Web 项目部署到 Tomcat 中，步骤如下：

在 IDEA 中对项目进行打包：右键项目→Build Artifacts→项目名:war→Build，生成 war 包（在项目的 out\artifacts 目录下）。
将生成的 war 包复制到 Tomcat 解压目录的 webapps 文件夹中。
启动 Tomcat，Tomcat 会自动解压 war 包生成同名项目目录。
打开浏览器，输入 http://localhost:8080/包名/页面名.jsp，即可访问项目。

六、总结

本文完成了 Java Web 开发的全套环境搭建：从 JDK、Tomcat 的环境变量配置，到 IDEA 的安装与 Web 项目创建，再到 Tomcat 在 IDEA 中的核心配置与项目部署，同时解决了'启动默认打开 index.jsp'的常见问题，还补充了 Tomcat 手动部署方法。

核心关键点总结：

所有路径不要包含中文和空格，否则会导致环境配置或项目启动失败；
JAVA_HOME 和 CATALINA_HOME 必须配置正确，分别对应 JDK 和 Tomcat 的根路径；
IDEA 中部署项目首选 war exploded 格式，支持热部署，开发更高效；
可通过 web.xml 或 IDEA 启动配置自定义默认访问页面。

掌握以上步骤后，就可以基于 IDEA+Tomcat 进行 JSP、Servlet 等 Java Web 基础开发了，后续可继续学习 HTTP 协议、XML 配置、过滤器、Servlet 等核心知识点，深入 Java Web 开发。

配套操作截图说明

为了让步骤更直观，以下为关键操作的截图对应位置（可根据实际操作截图补充）：

JDK 环境变量配置：此电脑→高级系统设置→环境变量界面，JAVA_HOME 和 Path 配置截图；
Tomcat 环境变量配置：CATALINA_HOME 新建配置截图；
Tomcat 启动验证：浏览器打开 localhost:8080 的 Tomcat 首页截图；
IDEA 添加 Web 支持：Add Framework Support勾选Web Application截图；
IDEA 配置 Tomcat：Edit Configurations中 Tomcat Server 的Application server和Deployment配置截图；
项目启动成功：IDEA 控制台启动日志和浏览器访问页面的截图。

Java Web 开发环境搭建：IDEA 与 Tomcat 安装部署指南

一、前置准备：JDK 环境配置

1. 下载与安装 JDK

2. 配置 JDK 系统环境变量

二、Tomcat 服务器安装与环境配置

1. 下载 Tomcat

2. 配置 Tomcat 环境变量

3. 验证 Tomcat 安装

4. Tomcat 基础修改（可选）

三、IDEA 安装与 Web 项目创建

1. IDEA 下载与安装

2. 在 IDEA 中创建 Java Web 项目

3. 编辑 JSP 页面（基础操作）

四、IDEA 中配置 Tomcat 并部署 Web 项目

1. 配置 Tomcat 服务器

2. 部署 Web 项目到 Tomcat

3. 启动 Tomcat 并运行 Web 项目

4. 常见问题解决：启动默认打开 index.jsp 而非自定义页面

方法 1：修改 IDEA 的 Tomcat 启动页面（最直接）

方法 2：修改 web.xml 配置欢迎页面

方法 3：浏览器手动访问自定义页面

五、Tomcat 手动部署项目（补充）

六、总结

配套操作截图说明

更多推荐文章

相关免费在线工具

Java Web 开发环境搭建：IDEA 与 Tomcat 安装部署指南

一、前置准备：JDK 环境配置

1. 下载与安装 JDK

2. 配置 JDK 系统环境变量

二、Tomcat 服务器安装与环境配置

1. 下载 Tomcat

2. 配置 Tomcat 环境变量

3. 验证 Tomcat 安装

4. Tomcat 基础修改（可选）

三、IDEA 安装与 Web 项目创建

1. IDEA 下载与安装

2. 在 IDEA 中创建 Java Web 项目

3. 编辑 JSP 页面（基础操作）

四、IDEA 中配置 Tomcat 并部署 Web 项目

1. 配置 Tomcat 服务器

2. 部署 Web 项目到 Tomcat

3. 启动 Tomcat 并运行 Web 项目

4. 常见问题解决：启动默认打开 index.jsp 而非自定义页面

方法 1：修改 IDEA 的 Tomcat 启动页面（最直接）

方法 2：修改 web.xml 配置欢迎页面

方法 3：浏览器手动访问自定义页面

五、Tomcat 手动部署项目（补充）

六、总结

配套操作截图说明

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具