JavaWeb 开发环境配置
从零搭建完整的 JavaWeb 开发环境,包括 JDK、Tomcat、Maven 和 IDE
一、安装 JDK(Java Development Kit)
JDK 是 Java 开发的基础,包含了编译器(javac)、运行时环境(JRE)和各种开发工具。
1. 下载 JDK
推荐使用 JDK 11 或 JDK 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 视图文件应放在此目录下。
六、环境检查清单
| 检查项 | 验证命令 | 期望结果 |
|---|---|---|
| JDK | java -version | 显示版本号 17.x |
| Maven | mvn -version | 显示版本号 3.9.x |
| Tomcat | 访问 http://localhost:8080 | 看到欢迎页 |
| IDEA | 运行 Web 项目 | 自动打开浏览器 |
📚 下一步:环境搭建完成后,学习
HTML 基本元素标记,
开始编写你的第一个网页!