9
0
0

第02章-开发环境搭建

2026-11-02
2026-11-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 环境变量配置

  使用安装包一路下一步完成安装后,需要手动配置两个环境变量。

  1. 右键此电脑,选择属性、高级系统设置、环境变量
  2. 在系统变量中新建 JAVA_HOME,值为 JDK 的安装目录,例如:
C:\Program Files\Java\jdk-21
  1. 找到系统变量中的 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 首次启动的必要配置

  启动后进入设置向导,重点做三件事:

  1. 选择主题(浅色或深色按个人习惯)
  2. 安装界面保持默认插件即可,后续按需添加
  3. 在欢迎页面选择 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:

  1. Maven home path 选择自己解压的 Maven 目录,而不是 Bundled(捆绑版)
  2. User settings file 勾选 Override,选择刚才修改的 settings.xml
  3. Local repository 会根据 settings.xml 自动刷新
  4. 打开 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 命令均可用。

  步骤:

  1. 完全关闭之前打开的所有命令行窗口,重新打开一个新窗口(环境变量改动后旧窗口不会刷新)
  2. 切换到任意非 JDK 目录,例如用户主目录
  3. 执行验证命令:
java -version
javac -version

  预期结果:两条命令均输出 21 版本信息,且不提示不是内部或外部命令、command not found 之类的错误。

实验二:验证 Tomcat 启动与关闭

  实验目的:独立完成 Tomcat 启动、首页访问、关闭的完整流程。

  步骤:

  1. 执行 bin 目录下的 startup 脚本
  2. 观察启动窗口,等待出现启动耗时信息,典型日志如下:
[main] org.apache.catalina.startup.Catalina.start Server startup in [1234] milliseconds
  1. 浏览器访问:
http://localhost:8080

  预期结果:页面显示 Tomcat 默认首页。

  1. 执行 shutdown 脚本,再次刷新浏览器页面

  预期结果:页面无法访问,提示无法连接或连接被拒绝,说明服务已真正停止。

实验三:验证 Maven 与镜像配置

  实验目的:确认 Maven 能通过镜像正常下载依赖。

  步骤:

  1. 新建一个空目录作为测试目录,在里面创建 pom.xml,内容使用 2.4.7 小节的最小示例,把 packaging 暂时改为 jar
  2. 在该目录下执行:
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。

  步骤:

  1. 在 IDEA 欢迎页选择 Open,打开实验三的测试目录
  2. 等待右下角索引和依赖导入完成
  3. 打开右侧 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。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

第02章-开发环境搭建
/archives/post-1793585519866
作者
Bam
发布于
2026-11-02
许可协议
CC BY-NC-SA 4.0

评论