Java Web 开发环境搭建：IDEA+Tomcat 安装与部署超详细教程

优质文章学习记录

— 10 min read
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 系统环境变量

  1. 右键此电脑→属性→高级系统设置→环境变量，进入环境变量配置界面。
  2. 新建用户变量：
    • 变量名：JAVA_HOME
    • 变量值：JDK 的安装根路径（示例：C:\Program Files\Java\jdk-24），点击确定。
  3. 编辑 Path 变量：
    • 在用户变量的Path中点击新建，输入%JAVA_HOME%\bin，将其上移至顶部，点击确定保存。
  4. 验证配置：按下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 环境变量

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

3. 验证 Tomcat 安装

  1. 打开 Tomcat 解压目录下的bin文件夹，双击startup.bat启动 Tomcat 服务器，会弹出黑窗口（不要关闭）。
  2. 打开浏览器，输入http://localhost:8080，若出现 Tomcat 默认首页，说明 Tomcat 启动成功。
  3. 关闭 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 下载与安装

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

2. 在 IDEA 中创建 Java Web 项目

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

  1. 打开 IDEA，点击New Project，选择Java，配置已安装的 JDK（IDEA 会自动识别JAVA_HOME中的 JDK），取消Create from template，点击Next。
  2. 输入项目名称（示例：javaweb_demo），选择项目保存路径（无中文 / 空格），点击Finish创建普通 Java 项目。
  3. 为项目添加 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）：

  1. 右键web目录→New→JSP/JSPX，输入文件名（如 cainiao），点击OK。
  2. 在 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 服务器

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

2. 部署 Web 项目到 Tomcat

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

3. 启动 Tomcat 并运行 Web 项目

  1. 点击 IDEA 右上角的Run（绿色三角）或Debug（绿色小虫子，调试模式），启动 Tomcat 服务器。
  2. 启动成功后，IDEA 控制台会显示Server startup in XXX ms，同时会自动打开浏览器，访问配置的启动页面（如http://localhost:8080/javaweb_demo/cainiao.jsp）。
  3. 若需修改代码，直接在 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 中，步骤如下：

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

六、总结

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

核心关键点总结：

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

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

配套操作截图说明

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

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

Read more

Flutter 三方库 deepyr 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、高颜值的类型安全 daisyUI 响应式 Web 应用架构

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 deepyr 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、高颜值的类型安全 daisyUI 响应式 Web 应用架构 在鸿蒙（OpenHarmony）系统的分布式 Web 容器、轻量级 JS 服务或高性能 Web 控制台中，如何快速搭建一套既符合现代审美又具备强类型约束的 UI？deepyr 做为对 daisyUI 组件库的类型安全（Typesafe）封装，为鸿蒙上的 Jaspr Web 应用提供了极致流畅的开发体验。本文将带您领略其在鸿蒙生态中的美学实战。 前言 什么是 Deepyr？它是一套基于 Jaspr（下一代 Dart Web 框架）的 UI
继续实践OpenClaw,好不容易把web 管理面板调通，再给它配上一个大模型

继续实践OpenClaw,好不容易把web 管理面板调通，再给它配上一个大模型

OpenClaw小龙虾是github 获得星标最多的项目，OpenClaw之所以能在GitHub上获得极高的关注度，主要原因在于它提供了一个功能强大、易于扩展的AI助手开发平台。把整个操作系统，打造成AI！ OpenClaw官网：OpenClaw — Personal AI Assistant 以前的安装记录：https://skywalk.blog.ZEEKLOG.net/article/details/157554991 本来感觉OpenClaw安装是挺简单的，没想到巨坑，有一台机器装好后没有web管理面板.....所以本来很简短的文档，写成了巨幅文档。 安装OpenClaw 先在192.168.1.12安装，但是它没有systemd服务，导致OpenClaw的服务无法自动启动。需要手工执行openclaw gateway命令启动。 后在192.168.1.19安装。但是装好后没有web管理面板，反复删除重装也没有，最后是安装的openclaw-cn ，才解决了问题。参见这个文档：https://skywalk.blog.ZEEKLOG.net/article/
视频续播功能实现 - 断点续看从前端到 Spring Boot 后端

视频续播功能实现 - 断点续看从前端到 Spring Boot 后端

🌷 古之立大事者，不惟有超世之才，亦必有坚忍不拔之志 🎐 个人CSND主页——Micro麦可乐的博客 🐥《Docker实操教程》专栏以最新的Centos版本为基础进行Docker实操教程，入门到实战 🌺《RabbitMQ》专栏19年编写主要介绍使用JAVA开发RabbitMQ的系列教程，从基础知识到项目实战 🌸《设计模式》专栏以实际的生活场景为案例进行讲解，让大家对设计模式有一个更清晰的理解 🌛《开源项目》本专栏主要介绍目前热门的开源项目，带大家快速了解并轻松上手使用 🍎 《前端技术》专栏以实战为主介绍日常开发中前端应用的一些功能以及技巧，均附有完整的代码示例 ✨《开发技巧》本专栏包含了各种系统的设计原理以及注意事项，并分享一些日常开发的功能小技巧 💕《Jenkins实战》专栏主要介绍Jenkins+Docker的实战教程，让你快速掌握项目CI/CD，是2024年最新的实战教程 🌞《Spring Boot》专栏主要介绍我们日常工作项目中经常应用到的功能以及技巧，代码样例完整 👍《Spring Security》专栏中我们将逐步深入Spring Security的各个