JavaWeb 开发环境配置

从零搭建完整的 JavaWeb 开发环境,包括 JDK、Tomcat、Maven 和 IDE

一、安装 JDK(Java Development Kit)

JDK 是 Java 开发的基础,包含了编译器(javac)、运行时环境(JRE)和各种开发工具。

1. 下载 JDK

推荐使用 JDK 11JDK 17(LTS 长期支持版本)。

JDK 版本类型推荐场景
Oracle JDK 17商业版企业生产环境
OpenJDK 17开源版学习和开发
Amazon Corretto 17开源版AWS 部署

2. 配置环境变量

Windows 系统:

:: 设置 JAVA_HOME
set JAVA_HOME=C:\Program Files\Java\jdk-17

:: 添加到 PATH
set PATH=%JAVA_HOME%\bin;%PATH%Windows CMD

Linux / macOS 系统:

# 编辑 ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

# 使配置生效
source ~/.bashrcBash

3. 验证安装

java -version
# 输出: openjdk version "17.0.x" ...

javac -version
# 输出: javac 17.0.xTerminal

二、安装 Apache Tomcat

Tomcat 是最流行的 Java Servlet 容器,用于运行 JSP 和 Servlet 应用。

1. 下载与解压

# 下载 Tomcat 9(推荐)
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.x/bin/apache-tomcat-9.0.x.tar.gz

# 解压到 /opt 目录
tar -xzf apache-tomcat-9.0.x.tar.gz -C /opt/
mv /opt/apache-tomcat-9.0.x /opt/tomcatBash

2. 配置环境变量

export CATALINA_HOME=/opt/tomcat
export PATH=$CATALINA_HOME/bin:$PATHBash

3. 目录结构说明

目录说明
bin/启动/关闭脚本(startup.sh, shutdown.sh)
conf/配置文件(server.xml, web.xml)
webapps/Web 应用部署目录
logs/日志文件
lib/Tomcat 和共享类库
work/JSP 编译后的临时文件

4. 启动与验证

# 启动 Tomcat
$CATALINA_HOME/bin/startup.sh

# 验证:浏览器访问 http://localhost:8080
# 看到 Tomcat 欢迎页面即表示成功

# 关闭 Tomcat
$CATALINA_HOME/bin/shutdown.shBash
✅ 端口修改:默认端口 8080,可在 conf/server.xml 中修改 <Connector port="8080"> 为其他端口。

三、安装 Apache Maven

Maven 是 Java 项目的构建和依赖管理工具,通过 pom.xml 管理项目配置。

1. 安装 Maven

# Linux: 使用包管理器安装
sudo apt install maven    # Ubuntu/Debian
sudo yum install maven    # CentOS/RHEL

# 或手动下载安装
wget https://dlcdn.apache.org/maven/maven-3/3.9.x/binaries/apache-maven-3.9.x-bin.tar.gz
tar -xzf apache-maven-3.9.x-bin.tar.gz -C /opt/
export M2_HOME=/opt/apache-maven-3.9.x
export PATH=$M2_HOME/bin:$PATHBash

2. 配置国内镜像(加速下载)

编辑 ~/.m2/settings.xml,添加阿里云镜像:

<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Aliyun Maven</name>
    <url>https://maven.aliyun.com/repository/central</url>
  </mirror>
</mirrors>XML

3. 常用 Maven 命令

命令说明
mvn clean清理编译输出
mvn compile编译源代码
mvn package打包(生成 WAR/JAR)
mvn install安装到本地仓库
mvn clean package清理后重新打包(最常用)

四、配置 IDE(IntelliJ IDEA)

IntelliJ IDEA 是最强大的 Java IDE,社区版免费且功能足够。

IDEA 配置 Tomcat

  • 打开 IDEA → File → Settings → Build → Application Servers
  • 点击 + → 选择 Tomcat Server → 指定 Tomcat 安装目录
  • 点击 Run → Edit Configurations → 添加 Tomcat Server → Local
  • Deployment 标签页添加你的 WAR 包(选择 exploded 模式方便调试)
  • 设置 Application context/,点击 Apply

IDEA 创建 Maven Web 项目

  • File → New → Project → 选择 Maven Archetype
  • 选择 Archetype: maven-archetype-webapp
  • 填写 GroupId(如 com.xjinping)和 ArtifactId(如 webdev-tutorial
  • 等待 Maven 下载依赖,项目结构自动生成
💡 其他 IDE 选择:Eclipse(免费)、VS Code + Java 插件包也可以进行 JavaWeb 开发,但 IDEA 的智能提示和调试功能最为强大。

五、JavaWeb 项目结构

一个标准的 Maven Web 项目目录结构如下:

project-root/
├── pom.xml                    ← Maven 配置文件
├── src/
│   └── main/
│       ├── java/              ← Java 源代码
│       │   └── com/xjinping/
│       │       ├── servlet/     ← Servlet 类
│       │       ├── filter/      ← 过滤器
│       │       └── model/       ← 数据模型
│       ├── resources/         ← 配置资源文件
│       └── webapp/            ← Web 根目录
│           ├── index.jsp      ← 首页
│           ├── css/             ← 样式文件
│           ├── js/              ← 脚本文件
│           └── WEB-INF/
│               ├── web.xml    ← Web 应用配置
│               └── views/       ← JSP 视图(受保护)
└── target/                    ← 编译输出目录Project Structure
⚠ 重要:WEB-INF 目录下的文件不能被浏览器直接访问,必须通过 Servlet 转发。这是一种安全机制,JSP 视图文件应放在此目录下。

六、环境检查清单

检查项验证命令期望结果
JDKjava -version显示版本号 17.x
Mavenmvn -version显示版本号 3.9.x
Tomcat访问 http://localhost:8080看到欢迎页
IDEA运行 Web 项目自动打开浏览器
📚 下一步:环境搭建完成后,学习 HTML 基本元素标记, 开始编写你的第一个网页!