第02章-开发环境搭建
第 02 章 开发环境搭建
工欲善其事,必先利其器。本章从零开始搭建整套 JavaWeb 开发环境,最终要达到的状态是:JDK 命令可用、IDEA 能创建 Web 工程、Tomcat 能启动并访问首页、Maven 能正常拉取依赖。
本章学习目标
- 安装 JDK 21 并配置环境变量,掌握验证方法
- 安装 IntelliJ IDEA 并了解关键配置
- 安装 Tomcat 10,熟悉各目录作用,能独立启动和关闭
- 安装 Maven,配置国内镜像加速,在 IDEA 中完成集成
- 完成四个环境验证实验,确认整套环境可用
版本对应关系需要先记住:本套教程使用 Jakarta Servlet 6.0,必须搭配 Tomcat 10 及以上版本;Tomcat 9 及以下使用的是旧的 javax 包名,二者不兼容。
2.1 JDK 21 安装
JDK(Java Development Kit)是 Java 开发工具包,包含编译、运行和调试 Java 程序所需的全部工具。JDK 21 是长期支持版本(LTS),适合作为学习和生产环境。
2.1.1 下载
从 Oracle 官方下载页面获取 JDK 21:
https://www.oracle.com/java/technologies/javase-downloads.html
也可以选择开源的 OpenJDK 发行版,例如 Eclipse Temurin:
https://adoptium.net/temurin/releases/
根据操作系统选择对应的安装包:Windows 选 .exe 或 .msi,macOS 选 .dmg(注意区分 Intel 芯片的 x64 和 Apple 芯片的 aarch64)。
2.1.2 Windows 环境变量配置
使用安装包一路下一步完成安装后,需要手动配置两个环境变量。
- 右键此电脑,选择属性、高级系统设置、环境变量
- 在系统变量中新建 JAVA_HOME,值为 JDK 的安装目录,例如:
C:\Program Files\Java\jdk-21
- 找到系统变量中的 Path,编辑并新增一条:
%JAVA_HOME%\bin
配置 PATH 的作用是让系统在任意目录下都能找到 java 和 javac 命令;JAVA_HOME 则是给 Tomcat、Maven、IDEA 等工具识别 JDK 位置使用的。
2.1.3 macOS 环境配置
使用 .dmg 安装包安装后,系统会自动把 JDK 放到统一目录。可以通过以下命令查看实际路径:
/usr/libexec/java_home -v 21
macOS 一般不需要手动配置环境变量即可直接使用。如果需要显式指定 JAVA_HOME,在用户主目录下的 .zshrc 文件中追加:
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH
保存后执行让配置生效:
source ~/.zshrc
2.1.4 验证安装
打开终端或命令行窗口,分别执行:
java -version
javac -version
预期输出(具体小版本号可能不同):
java version "21.0.5" 2025-10-21 LTS
Java(TM) SE Runtime Environment (build 21.0.5+9-LTS-239)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.5+9-LTS-239, mixed mode, sharing)
javac 21.0.5
java 是运行命令,javac 是编译命令,两条都能输出版本号说明 JDK 安装和环境变量配置成功。
2.2 IntelliJ IDEA 安装
IDEA 是 Java 开发中最主流的集成开发环境,对 Maven、Tomcat、Web 工程有完善的支持。
2.2.1 下载与安装
从 JetBrains 官方网站下载:
https://www.jetbrains.com/idea/
IDEA 分为两个版本:
- Ultimate(旗舰版):支持 Java Web、Tomcat 集成、数据库工具等完整功能,学生可凭教育邮箱申请免费授权
- Community(社区版):开源免费,但不原生支持 Tomcat 和 Web 工程部署
学习 JavaWeb 建议使用旗舰版。下载页面按操作系统选择安装包,安装过程保持默认选项即可。Windows 安装时建议勾选 Create Desktop Shortcut 和 Add "Open Folder as Project"。
2.2.2 首次启动的必要配置
启动后进入设置向导,重点做三件事:
- 选择主题(浅色或深色按个人习惯)
- 安装界面保持默认插件即可,后续按需添加
- 在欢迎页面选择 Customize、All settings,先确认 2.4 节的 Maven 配置
2.2.3 常用快捷键(macOS 与 Windows 对照)
| 功能 | Windows/Linux | macOS |
|---|---|---|
| 代码补全 | Ctrl + Space | Control + Space |
| 快速修复 | Alt + Enter | Option + Enter |
| 运行程序 | Shift + F10 | Control + R |
| 调试程序 | Shift + F9 | Control + D |
| 格式化代码 | Ctrl + Alt + L | Command + Option + L |
| 查找类 | Ctrl + N | Command + O |
| 全局搜索 | Ctrl + Shift + F | Command + Shift + F |
| 注释/取消注释 | Ctrl + / | Command + / |
2.3 Tomcat 10 安装
2.3.1 Web 服务器与 Servlet 容器
Tomcat 既是一个 Web 服务器,也是一个 Servlet 容器,承担两类职责:
- 监听特定端口,接收浏览器发来的 HTTP 请求并返回响应
- 识别请求中的动态资源路径,调用对应的 Servlet 类执行业务逻辑,把结果写回响应
只安装 JDK 无法运行 Web 项目,因为 JDK 中不包含 Servlet 规范的实现;Tomcat 提供了这套实现以及 HTTP 网络通信能力。
2.3.2 下载与解压
从 Tomcat 官方网站下载 10.1.x 版本:
https://tomcat.apache.org/
左侧选择 Tomcat 10 分类,在 Core 区域下载:
- Windows:64-bit Windows zip
- macOS/Linux:tar.gz 或 zip
Tomcat 是绿色软件,不需要安装,把压缩包解压到一个不含中文和空格的目录即可,例如:
Windows: D:\dev\apache-tomcat-10.1.34
macOS: /Users/用户名/dev/apache-tomcat-10.1.34
路径中如果含有中文或空格,部分脚本和插件可能出现解析错误。
2.3.3 目录结构详解
解压后各目录的作用如下:
| 目录 | 作用 | 关键内容 |
|---|---|---|
| bin | 启动、关闭和运行控制脚本 | startup 启动脚本、shutdown 关闭脚本、catalina 核心脚本 |
| conf | 全局配置文件 | server.xml 端口与连接器配置、web.xml 全局 Web 配置、tomcat-users.xml 管理用户 |
| lib | 运行依赖的 jar 包 | Servlet API、JSP API 及 Tomcat 核心组件 |
| webapps | 应用部署目录 | ROOT 为默认应用,war 包放到这里会自动解压部署 |
| work | JSP 编译缓存目录 | JSP 第一次访问时被翻译成 Servlet 的 class 文件 |
| temp | 临时文件目录 | 运行过程中的临时缓存 |
| logs | 日志目录 | catalina 日志、访问日志、localhost 日志 |
2.3.4 启动与关闭
Windows 下双击 bin 目录中的 startup.bat,或在命令行执行:
startup.bat
macOS/Linux 下在终端进入 bin 目录执行:
chmod +x *.sh
./startup.sh
chmod 只需要第一次执行,作用是给脚本添加可执行权限。
也可以直接使用 catalina 脚本以前台方式启动,日志直接输出在当前窗口,便于观察报错:
catalina.sh run
关闭服务执行 shutdown 脚本:
# Windows
shutdown.bat
# macOS/Linux
./shutdown.sh
2.3.5 验证启动成功
启动后打开浏览器访问:
http://localhost:8080
预期结果:浏览器显示 Tomcat 自带的默认首页,页面上有大字标题和版本信息。能看到这个页面说明 HTTP 服务、端口监听和默认应用全部正常。
启动失败最常见的两个原因:
- 8080 端口被其他程序占用,可在命令行用 netstat -ano | findstr 8080(Windows)或 lsof -i:8080(macOS)排查,然后修改 conf/server.xml 中的端口
- JAVA_HOME 没有配置,Tomcat 启动窗口会一闪而过,回到 2.1 节检查环境变量
2.4 Maven 安装与配置
2.4.1 Maven 解决什么问题
没有 Maven 时,项目需要依赖的第三方 jar 包要手动下载、手动拷贝、手动处理 jar 包之间的依赖关系,编译打包也全靠手工命令。Maven 是 Java 项目的自动化构建和依赖管理工具,核心能力有两项:
- 依赖管理:在 pom.xml 中声明坐标,Maven 自动从仓库下载 jar 包及其传递依赖
- 标准化构建:统一提供编译、测试、打包、部署等生命周期命令
2.4.2 下载安装
从官方网站下载 3.9.x 稳定版的压缩包:
https://maven.apache.org/download.cgi
解压到不含中文和空格的目录,例如:
D:\dev\apache-maven-3.9.9
配置环境变量:新建 MAVEN_HOME 指向解压目录,再把下面的路径加入 PATH:
%MAVEN_HOME%\bin
macOS 下在 .zshrc 中追加:
export MAVEN_HOME=/Users/用户名/dev/apache-maven-3.9.9
export PATH=$MAVEN_HOME/bin:$PATH
验证安装:
mvn -v
预期输出:
Apache Maven 3.9.9
Maven home: /Users/用户名/dev/apache-maven-3.9.9
Java version: 21.0.5, vendor: Oracle Corporation
Default locale: zh_CN, platform encoding: UTF-8
输出中能同时看到 Maven 版本和 JDK 21,说明两者关联正常。
2.4.3 仓库与镜像概念
Maven 中的仓库分三类:
- 本地仓库:本机磁盘上的目录,下载过的 jar 包缓存在这里,默认在用户目录下的 .m2/repository
- 中央仓库:Maven 社区维护的公共仓库,服务器在国外,国内直连速度慢
- 镜像仓库:替代中央仓库提供相同内容的站点,配置国内镜像可以显著加快下载速度
2.4.4 配置本地仓库路径
打开 Maven 解压目录下 conf/settings.xml,找到 localRepository 注释项,配置自定义本地仓库目录:
<localRepository>D:/dev/maven-repository</localRepository>
macOS 下可写为:
<localRepository>/Users/用户名/dev/maven-repository</localRepository>
2.4.5 配置国内镜像
在 settings.xml 的 mirrors 标签内加入镜像配置:
<mirrors>
<mirror>
<id>aliyun-public</id>
<mirrorOf>central</mirrorOf>
<name>aliyun public repository</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
mirrorOf 写 central 表示所有原本发往中央仓库的请求都转到这个镜像。一个镜像即可满足绝大多数入门需求,后续需要 Spring、Google 等其他仓库时再追加。
下面给出一份结构完整、可直接使用的 settings.xml:
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
https://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository>/Users/用户名/dev/maven-repository</localRepository>
<mirrors>
<mirror>
<id>aliyun-public</id>
<mirrorOf>central</mirrorOf>
<name>aliyun public repository</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
<profiles>
<profile>
<id>jdk21-profile</id>
<properties>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
</profile>
</profiles>
<activeProfiles>
<activeProfile>jdk21-profile</activeProfile>
</activeProfiles>
</settings>
2.4.6 在 IDEA 中集成 Maven
打开 IDEA,进入自定义设置(Customize 中的 All settings,或在项目内打开 Settings),找到 Build, Execution, Deployment 下的 Build Tools、Maven:
- Maven home path 选择自己解压的 Maven 目录,而不是 Bundled(捆绑版)
- User settings file 勾选 Override,选择刚才修改的 settings.xml
- Local repository 会根据 settings.xml 自动刷新
- 打开 Maven 下的 Runner 子项,确认 JRE 选择的是 JDK 21
建议在欢迎页面的全局设置中配置,这样以后新建的每个项目都默认使用这套 Maven。
2.4.7 Maven 坐标与 pom.xml
Maven 通过三个字段唯一定位一个 jar 包,合称坐标:
- groupId:组织或团队标识,通常取域名倒写,如 com.iooi
- artifactId:项目或模块名称
- version:版本号
工程根目录下的 pom.xml 是 Maven 的核心配置文件,最小示例如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.iooi</groupId>
<artifactId>demo-project</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
<properties>
<maven.compiler.source>21</maven.compiler.source>
<maven.compiler.target>21</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
</project>
packaging 决定打包方式:普通 Java 程序用 jar,Web 工程用 war。SNAPSHOT 表示开发中的快照版本,正式发布时改为不带 SNAPSHOT 的版本号。
2.5 上机实操:环境综合验证
实验一:验证 JDK 环境
实验目的:确认任意目录下 java 与 javac 命令均可用。
步骤:
- 完全关闭之前打开的所有命令行窗口,重新打开一个新窗口(环境变量改动后旧窗口不会刷新)
- 切换到任意非 JDK 目录,例如用户主目录
- 执行验证命令:
java -version
javac -version
预期结果:两条命令均输出 21 版本信息,且不提示不是内部或外部命令、command not found 之类的错误。
实验二:验证 Tomcat 启动与关闭
实验目的:独立完成 Tomcat 启动、首页访问、关闭的完整流程。
步骤:
- 执行 bin 目录下的 startup 脚本
- 观察启动窗口,等待出现启动耗时信息,典型日志如下:
[main] org.apache.catalina.startup.Catalina.start Server startup in [1234] milliseconds
- 浏览器访问:
http://localhost:8080
预期结果:页面显示 Tomcat 默认首页。
- 执行 shutdown 脚本,再次刷新浏览器页面
预期结果:页面无法访问,提示无法连接或连接被拒绝,说明服务已真正停止。
实验三:验证 Maven 与镜像配置
实验目的:确认 Maven 能通过镜像正常下载依赖。
步骤:
- 新建一个空目录作为测试目录,在里面创建 pom.xml,内容使用 2.4.7 小节的最小示例,把 packaging 暂时改为 jar
- 在该目录下执行:
mvn help:system
预期结果:Maven 开始下载插件,日志中出现从镜像站点下载的记录:
Downloading from aliyun-public: https://maven.aliyun.com/repository/public/...
...
BUILD SUCCESS
看到 BUILD SUCCESS 且下载地址为配置的镜像域名,说明 settings.xml 生效、网络通畅。
实验四:验证 IDEA 与 Maven 联动
实验目的:确认 IDEA 使用的是自定义 Maven 且能识别 pom.xml。
步骤:
- 在 IDEA 欢迎页选择 Open,打开实验三的测试目录
- 等待右下角索引和依赖导入完成
- 打开右侧 Maven 面板,展开 Lifecycle,双击 compile
预期结果:控制台输出构建成功:
[INFO] Building demo-project 1.0-SNAPSHOT
[INFO] ----------------------------------------
[INFO] BUILD SUCCESS
工程目录下生成 target 文件夹,说明 IDEA、Maven、JDK 三者已经打通。
2.6 常见问题排查
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| java 命令找不到 | PATH 未配置或配置后未重开窗口 | 检查 JAVA_HOME 与 PATH,重新打开终端 |
| Tomcat 窗口一闪而过 | JAVA_HOME 缺失或路径错误 | 用 catalina run 前台启动查看具体报错 |
| 8080 端口无法访问 | 端口被占用或防火墙拦截 | 排查占用进程,修改 server.xml 端口 |
| Maven 下载很慢 | 镜像未生效,仍在访问中央仓库 | 检查 settings.xml 路径和 mirrorOf 配置 |
| IDEA 依赖报红 | Maven 未刷新或网络下载失败 | 点击 Maven 面板刷新按钮,检查本地仓库 |
| 控制台中文乱码 | 编码不统一 | 确认 IDEA 文件编码为 UTF-8,pom 中声明 sourceEncoding |
2.7 本章小结
- JDK 21 提供 Java 编译运行能力,通过 java -version 和 javac -version 验证
- IDEA 旗舰版是 JavaWeb 开发的主力工具,教育用户可申请免费授权
- Tomcat 10 是 Servlet 6.0 的运行容器,解压即用,bin 控制启停、conf 存放配置、webapps 部署应用
- Maven 通过 pom.xml 坐标管理依赖,配置国内镜像后下载速度明显改善
- 四个验证实验全部通过后,环境准备完毕
下一章将正式进入 JavaWeb 核心技术,创建第一个 Web 工程并编写 Servlet。

