在 Java Web 开发中，IntelliJ IDEA 搭配 Tomcat 是业界标准的入门组合。本文将梳理从 JDK 环境配置、Tomcat 部署到 IDEA 集成的完整流程，重点解决环境搭建中的常见坑点，确保项目能顺利跑起来。
一、JDK 环境准备
Java Web 的核心基础是 JDK，Tomcat 和 IDEA 的运行都依赖它。先完成安装与环境变量配置。
1. 下载与安装
前往 Oracle 或 OpenJDK 官网下载对应系统的安装包（以 Windows 64 位为例）。本文使用 JDK 24 版本，双击按默认步骤安装，记住安装路径，例如 C:\Program Files\Java\jdk-24。
2. 配置环境变量
- 右键此电脑→属性→高级系统设置→环境变量。
- 新建用户变量：
- 变量名：
JAVA_HOME - 变量值：JDK 根路径（如
C:\Program Files\Java\jdk-24）
- 变量名：
- 编辑 Path 变量：在用户变量的 Path 中新建
%JAVA_HOME%\bin，并上移至顶部。 - 验证：打开命令行输入
java -version和javac -version，看到版本号即成功。
二、Tomcat 服务器配置
Tomcat 是轻量级 Web 应用服务器，支持 JSP 和 Servlet。本文使用 Tomcat 9.0.115 版本。
1. 下载与解压
从 Apache 官网下载 Windows 64 位压缩包，解压到指定目录。注意路径不要包含中文或空格，例如 D:\java web\apache-tomcat-9.0.115-windows-x64\apache-tomcat-9.0.115。
2. 配置环境变量
- 再次进入环境变量界面，新建用户变量：
- 变量名：
CATALINA_HOME - 变量值：Tomcat 解压根路径
- 变量名：
- 编辑 Path 变量：新建
%CATALINA_HOME%\bin。
3. 启动验证
- 进入
bin目录，双击startup.bat启动服务（黑窗口勿关闭）。 - 浏览器访问
http://localhost:8080，出现默认首页即成功。 - 停止服务双击
shutdown.bat。
提示：若端口被占用，可修改
conf\server.xml中的 Connector 端口（如改为 8081），重启生效。
三、IDEA 安装与 Web 项目创建
IDEA 分为社区版和旗舰版，Java Web 开发建议使用旗舰版以获得更好的 Servlet/JSP 支持。
1. 安装 IDEA
从 JetBrains 官网下载后，按向导安装。建议勾选 Add launchers to PATH 以便命令行调用。
2. 创建 Web 项目
- 点击 New Project，选择 Java，配置已安装的 JDK。
- 取消 Create from template，输入项目名称（如
javaweb_demo），点击 Finish。 - 添加 Web 支持：右键项目根目录 → Add Framework Support → 勾选 Web Application → 勾选 Create web.xml。
- 项目会自动生成
web目录及WEB-INF结构，Web 项目框架即搭建完毕。
3. 编写 JSP 页面
在 web 目录下新建 JSP 文件，例如 cainiao.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 并部署
这是最关键的一步，配置完成后无需手动操作 Tomcat 脚本。
1. 配置 Tomcat 服务器
- 点击右上角 Edit Configurations。
- 点击 + 号，选择 Tomcat Server → Local。
- 点击 Configure，指向 Tomcat 的解压根路径，IDEA 会自动识别版本。
- 设置 Name（如 Tomcat9）和 HTTP port（保持 8080 或自定义端口）。
2. 部署项目
切换到 Deployment 选项卡：
- 点击 + 号，选择 Artifact → 项目名:war exploded。
*注：开发阶段首选 war exploded，支持热部署，修改代码无需重新打包。
- 设置 Application context，默认为
/项目名，也可简化为/。 - 设置 Startup page，填入启动页路径（如
/cainiao.jsp）。 - 点击 Apply 保存。
3. 运行项目
点击右上角绿色三角运行按钮。控制台显示 Server startup in XXX ms 后，浏览器会自动打开配置的页面。若需修改代码，直接编辑后刷新即可看到效果。
五、常见问题与手动部署
启动默认页面问题
如果启动仍默认打开 index.jsp 而非自定义页面，有三种解法：
- IDEA 配置：回到 Deployment 设置，修改 Startup page 路径。
- web.xml 配置：在
WEB-INF/web.xml中添加欢迎页面列表：
<welcome-file-list>
<welcome-file>cainiao.jsp</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
- 手动访问：直接在浏览器输入完整路径
http://localhost:8080/项目上下文路径/页面名.jsp。
手动部署 WAR 包
除了 IDE 集成，也可将项目打包为 WAR 部署：
- 右键项目 → Build Artifacts → 选择 项目名:war → Build。
- 将生成的
.war文件复制到 Tomcat 的webapps目录。 - 启动 Tomcat，自动解压并运行。
六、核心要点总结
- 路径规范：所有安装路径严禁包含中文和空格，否则极易导致启动失败。
- 环境变量：
JAVA_HOME和CATALINA_HOME必须准确指向根目录。 - 部署模式：IDEA 内优先使用
war exploded进行开发，效率更高。 - 默认页：可通过 IDEA 配置或
web.xml调整启动时的默认页面。
掌握以上步骤后，即可基于 IDEA+Tomcat 开展 JSP、Servlet 等 Java Web 基础开发工作。后续可进一步深入 HTTP 协议、过滤器及 Servlet 生命周期等核心知识点。
