Java Web 开发环境搭建：IDEA 与 Tomcat 配置指南

三、IDEA 安装与 Web 项目创建

IDEA 分为社区版（免费）和旗舰版（付费）。Java Web 开发建议使用旗舰版，因为它对 Servlet、JSP 和 Tomcat 集成的支持更完善。

1. IDEA 安装

前往 JetBrains 官网下载并安装。安装时勾选 Add launchers to PATH 以便在终端直接调用。社区版可直接使用，旗舰版有试用期。

2. 创建 Java Web 项目

IDEA 创建 Web 项目推荐采用'普通 Java 项目 + 添加 Web 支持'的方式，灵活性更高。

1. 点击 New Project → 选择 Java，配置已安装的 JDK，取消 Create from template，点击 Next。
2. 输入项目名称（如 javaweb_demo），选择无中文/空格的保存路径，点击 Finish。
3. 添加 Web 支持：
   • 右键项目根目录 → Add Framework Support。
   • 勾选 Web Application，并勾选 Create web.xml（生成核心配置文件）。
   • 点击 OK，项目会自动生成 web 目录及 WEB-INF 结构。

3. 编写测试页面

在 web 目录下新建 JSP 文件（如 index.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 并部署项目

这是最关键的一步，配置完成后即可在 IDE 内直接管理服务器，无需手动操作脚本。

1. 配置 Tomcat 服务器

1. 点击右上角下拉框 → Edit Configurations。
2. 点击 + 号 → 选择 Tomcat Server → Local。
3. 在 Application server 处点击 Configure，选择之前解压的 Tomcat 根路径，IDEA 会自动识别版本。
4. 配置基础信息：
   • Name：自定义（如 Tomcat9）。
   • HTTP port：与 Tomcat 配置的端口一致（默认 8080）。
   • 勾选 After launch → Open browser（启动后自动打开浏览器）。
5. 切换到 Deployment 选项卡。

2. 部署 Web 项目

1. 在 Deployment 选项卡中，点击 + 号 → 选择 Artifact → 项目名:war exploded。
   • *注：开发阶段推荐使用 war exploded，支持热部署，修改代码后无需重新打包。
2. 配置 Application context（上下文路径）：
   • 默认为 /项目名，也可简化为 /（通过 localhost:8080 直接访问）。
3. 点击 Apply → OK 保存配置。

3. 启动与调试

1. 点击 IDEA 右上角的绿色三角（Run）或虫子图标（Debug）启动服务器。
2. 控制台显示 Server startup in XXX ms 即表示成功。
3. 浏览器自动跳转至项目页面。若需修改代码，直接在 IDEA 编辑后刷新浏览器即可生效（热部署）。

4. 常见问题：默认页面未生效

如果启动后仍默认打开 index.jsp 而非自定义页面，可通过以下方式调整：

• 方法 1：修改 IDEA 启动配置 回到 Edit Configurations → Deployment，将 Startup page 改为自定义页面路径（如 /cainiao.jsp）。

• 方法 2：修改 web.xml 欢迎页列表 在项目 WEB-INF/web.xml 中添加欢迎页面配置，优先指定自定义页面：

<welcome-file-list>
    <welcome-file>cainiao.jsp</welcome-file>
    <welcome-file>index.jsp</welcome-file>
</welcome-file-list>

• 方法 3：手动访问 直接在浏览器地址栏输入完整路径：http://localhost:8080/项目上下文路径/自定义页面.jsp。

五、Tomcat 手动部署（补充）

除了 IDEA 集成部署，也可以手动将项目部署到 Tomcat，适用于生产环境或独立运行场景。

1. 在 IDEA 中对项目进行打包：右键项目 → Build Artifacts → 项目名:war → Build。
2. 将生成的 .war 包复制到 Tomcat 的 webapps 目录。
3. 重启 Tomcat，服务器会自动解压该包。
4. 浏览器访问 http://localhost:8080/包名/页面名.jsp。

六、总结

完成上述步骤后，你的 Java Web 开发环境已就绪。以下是几个关键注意点：

1. 路径规范：所有安装路径和项目路径避免包含中文和空格，防止解析错误。
2. 环境变量：JAVA_HOME 和 CATALINA_HOME 必须准确指向根目录。
3. 部署方式：开发阶段首选 IDEA 的 war exploded 模式，效率更高；生产环境可使用标准 .war 包。
4. 页面配置：默认访问页面可通过 web.xml 或 IDEA 启动配置灵活调整。

掌握这些基础后，即可开始学习 Servlet、Filter 等核心知识，深入 Java Web 开发。