跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Javajava

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

了 Java Web 开发环境的搭建流程，涵盖 JDK 环境变量配置、Tomcat 服务器安装及 IDEA 集成部署。重点说明了项目创建、Web 支持添加、Tomcat 本地配置以及常见问题处理，帮助开发者快速完成从环境准备到应用运行的全过程。

协议工匠发布于 2026/4/11更新于 2026/7/1837 浏览
Java Web 开发环境搭建：IDEA 与 Tomcat 配置指南

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

在 Java Web 开发中，IntelliJ IDEA 搭配 Tomcat 是主流且高效的组合。本文将基于实际开发需求，从 JDK 环境配置、Tomcat 安装部署到 IDEA 集成运行，梳理一套完整的本地开发环境搭建流程。

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

Java Web 的核心基础是 JDK，Tomcat 和 IDEA 的运行都依赖它。建议安装 JDK 17 或更高版本（LTS 版）。

1. 下载与安装 JDK

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

2. 配置系统环境变量

  1. 右键此电脑→属性→高级系统设置→环境变量。
  2. 新建用户变量：
    • 变量名：JAVA_HOME
    • 变量值：JDK 的安装根路径（如 C:\Program Files\Java\jdk-21），点击确定。
  3. 编辑 Path 变量：
    • 在用户变量的Path中点击新建，输入 %JAVA_HOME%\bin。
    • 将其上移至顶部，确保优先级最高，保存退出。
  4. 验证配置：打开命令行（cmd），输入 java -version 和 javac -version，若显示版本信息则配置成功。

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

Tomcat 是轻量级 Web 应用服务器，支持 Servlet 和 JSP 运行。本文以 Tomcat 9.x 版本为例。

1. 下载与解压

前往 Apache Tomcat 官网下载 Windows 64 位压缩包。注意：解压路径不要包含中文和空格，否则可能导致启动失败。建议解压到类似 D:\tools\apache-tomcat-9.0.x 的目录。

2. 配置环境变量

  1. 再次打开环境变量界面，新建用户变量：
    • 变量名：CATALINA_HOME
    • 变量值：Tomcat 的解压根路径（如 D:\tools\apache-tomcat-9.0.x）。
  2. 编辑 Path 变量：在 Path 中新建，输入 %CATALINA_HOME%\bin，保存。

3. 验证安装

  1. 进入 Tomcat 的 bin 目录，双击 startup.bat 启动服务（黑窗口请勿关闭）。
  2. 浏览器访问 http://localhost:8080，若看到 Tomcat 默认首页，说明启动成功。
  3. 停止服务可双击 shutdown.bat。

提示：若 8080 端口被占用，可修改 conf\server.xml 中的 <Connector port="8080" ...> 为其他端口（如 8081）。

三、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 开发。

目录

  1. Java Web 开发环境搭建：IDEA 与 Tomcat 配置指南
  2. 一、前置准备：JDK 环境配置
  3. 1. 下载与安装 JDK
  4. 2. 配置系统环境变量
  5. 二、Tomcat 服务器安装与环境配置
  6. 1. 下载与解压
  7. 2. 配置环境变量
  8. 3. 验证安装
  9. 三、IDEA 安装与 Web 项目创建
  10. 1. IDEA 安装
  11. 2. 创建 Java Web 项目
  12. 3. 编写测试页面
  13. 四、IDEA 中配置 Tomcat 并部署项目
  14. 1. 配置 Tomcat 服务器
  15. 2. 部署 Web 项目
  16. 3. 启动与调试
  17. 4. 常见问题：默认页面未生效
  18. 五、Tomcat 手动部署（补充）
  19. 六、总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • 智能家居到智慧城市的数据安全挑战与真实攻击案例
  • JavaScript 中 var、let、const 的核心区别与实战应用
  • C++ 搜索引擎项目：正倒排索引数据清洗代码详解（上）
  • TongWeb 通道参数详解：maxQueueSize 与 acceptCount 的区别与协作
  • Anaconda 安装与 Python 环境配置指南
  • 100倍提速！OpenAI Consistency Model终结AI绘画等待时代
  • 50 道前端核心面试题：涵盖 HTML CSS JS Vue React TypeScript 及工程化
  • EvoCUA 刷新开源 SOTA：会操作电脑且持续进化的智能体
  • LLM 大模型基础知识：从入门到应用实践指南
  • Flutter 与 OpenHarmony 下 web_socket 标准 WebSocket 客户端跨平台实现
  • Heygem 数字人系统 Linux 环境依赖安装步骤
  • NVILA：8B 参数 VLM 挑战 GPT-4o mini，训练成本降低 4.5 倍
  • Python 爬虫实战：DrissionPage 之 SessionPage 与 WebPage 模块详解
  • Linux 基础开发工具使用指南（上）
  • SQL 多表查询详解：连接与子查询应用
  • AIGC 重塑文学创作：机遇、挑战与应对之道
  • 基于 Spring Boot 和 WebSocket 的实时聊天室系统
  • OpenClaw 本地 AI 代理技术架构与实战部署详解
  • 大学生论文 AI 写作工具优选，省时且保学术严谨性
  • llama.cpp 量化模型部署实战：从模型转换到 API 服务

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online