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 官网下载对应系统（本文以 Windows10 64 位为例）的 JDK 安装包，本文使用 JDK24 版本，双击安装包按默认步骤完成安装，记住安装路径（示例：C:\Program Files\Java\jdk-24）。
2. 配置 JDK 系统环境变量
- 右键此电脑→属性→高级系统设置→环境变量，进入环境变量配置界面。
- 新建用户变量：
- 变量名：
JAVA_HOME - 变量值：JDK 的安装根路径（示例：
C:\Program Files\Java\jdk-24），点击确定。
- 变量名：
- 编辑 Path 变量：
- 在用户变量的Path中点击新建，输入
%JAVA_HOME%\bin，将其上移至顶部，点击确定保存。
- 在用户变量的Path中点击新建，输入
- 验证配置：按下
Win+R输入cmd打开命令行，输入java -version和javac -version，若显示 JDK 版本信息，说明配置成功。
二、Tomcat 服务器安装与环境配置
Tomcat 是开源的轻量级 Web 应用服务器，专为 Java Web 开发设计，支持 JSP 和 Servlet 运行，本文使用 Tomcat9.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 代码，示例：
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。
- 点击Configure，选择 Tomcat 的解压根路径（示例：
- 配置服务器基础信息：
- 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
<?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 控制台启动日志和浏览器访问页面的截图。
