开发环境与构建（零基础详细版，含 Maven 全流程）

学习目标与前置

建议用时：60-120 分钟准备：Windows 或 macOS 一台

• 安装并验证 JDK 17+。
• 安装并验证 Maven 3.8+，配置镜像与本地仓库路径。
• 安装 IDEA（社区版即可），导入并运行 Maven 项目。
• 理解 Maven 坐标、依赖范围、生命周期与常用命令。
• 用命令行创建项目、编译、测试、打包并运行。
• 掌握 Git 的 init/add/commit/status/push。

Step 1：安装 JDK 17+

1. 下载：Oracle JDK 或 Adoptium，选 17 LTS。
2. 安装：Windows 一路 Next；macOS 拖入 Applications。
3. 配置环境变量（Windows）：
   • 新建系统变量 JAVA_HOME 指向 JDK 安装目录（例：C:\Program Files\Java\jdk-17）。
   • 在 Path 添加 %JAVA_HOME%\bin。
4. 验证：终端执行 java -version、javac -version，应显示 17.x。

Step 2：安装 Maven 3.8+

1. 下载：官方下载，选 Binary zip/tar.gz。
2. 解压到如 C:\dev\apache-maven-3.9.9（macOS 可放 /Users/<name>/dev/apache-maven-3.9.9）。
3. 配置环境变量（Windows）：新建 MAVEN_HOME 指向解压目录，在 Path 添加 %MAVEN_HOME%\bin。
4. 验证：终端执行 mvn -v，应显示 Maven 版本与 Java 17。

本地仓库默认路径：~/.m2/repository（Windows 为 C:\Users\<用户>\.m2\repository）。

Step 3：配置镜像与本地仓库（settings.xml）

flowchart TD
  A[安装 JDK] --> B[安装 Maven]
  B --> C[配置 settings.xml 镜像/本地仓库]
  C --> D[mvn archetype 生成项目]
  D --> E[mvn clean/package/test/install]
  E --> F[IDEA 导入运行]

编辑 ~/.m2/settings.xml（没有则创建）。示例：阿里云镜像 + 指定本地仓库路径。

<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>D:/maven-repo</localRepository>
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <mirrorOf>central</mirrorOf>
      <name>aliyun maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>
</settings>

作用：加速依赖下载；本地仓库存放依赖，重用后不再重复下载。

Step 4：用命令行创建第一个 Maven 项目

1. 在目标目录打开终端（Win 地址栏输入 cmd）。
2. 生成最小示例工程：

mvn archetype:generate ^
  -DgroupId=demo ^
  -DartifactId=hello-maven ^
  -DarchetypeArtifactId=maven-archetype-quickstart ^
  -DinteractiveMode=false

说明：groupId=组织或域名倒写；artifactId=项目名；archetype=骨架模板。

3. 进入目录并编译/打包：

cd hello-maven
mvn clean package

首次会下载依赖。成功后 target/hello-maven-1.0-SNAPSHOT.jar 生成。

4. 运行：

java -cp target/hello-maven-1.0-SNAPSHOT.jar demo.App

应输出 “Hello World!”。

Step 5：理解项目结构、POM、依赖范围

• src/main/java 业务代码；src/test/java 测试代码。
• pom.xml：定义坐标、依赖、插件。
• 依赖范围 scope：compile（默认，全程可用）、provided（编译/测试可用，运行由容器提供，如 Servlet API）、test（仅测试，如 JUnit）、runtime（运行期需要，如 JDBC Driver）、system（几乎不用）。

<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>demo</groupId>
  <artifactId>hello-maven</artifactId>
  <version>1.0-SNAPSHOT</version>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.13.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

Step 6：掌握 Maven 生命周期与常用命令

• 核心阶段（phase）：clean 清理、compile 编译、test 测试、package 打包、install 安装到本地仓库。
• 执行某阶段会自动执行之前的阶段（执行 package 会先 compile/test）。
• 常用：mvn clean、mvn clean package、mvn test、mvn install。
• 查看坐标/属性：mvn help:evaluate -Dexpression=project.version。

Step 7：在 IDEA 中导入与运行

1. IDEA → Open → 选 hello-maven 目录。
2. 等待依赖下载（右下角进度）。
3. 右键 src/main/java/demo/App.java → Run ‘App.main’。
4. IDEA Maven 面板可点击生命周期（clean/package）。

若提示 JDK 未配置：File → Project Structure → SDK 选择 JDK 17。

Step 8：Git 最小使用

cd hello-maven
git init
git status
git add .
git commit -m "init project"
# 若有远程
git remote add origin https://your.git.repo/hello-maven.git
git push -u origin main

• .gitignore：使用 Java/Maven 模板，忽略 target、IDE 配置等。
• 改动后用 git status 看红/绿文件，git diff 查看差异。

常见报错与排查

• mvn 不是内部命令：检查 MAVEN_HOME/Path，重开终端。
• JAVA_HOME 未设置：设置 JDK 路径并在 Path 中加 %JAVA_HOME%\bin。
• 依赖下载失败：配置镜像；检查网络/代理；清理本地仓库后重试。
• IDEA SDK 未设置：Project Structure 中选择 JDK 17。

课堂练习

• 修改 App.java 输出 “Hello Java Web”。
• 新增 Calculator.add 方法，并写 JUnit 测试断言 add(1,2)=3，运行 mvn test。

课后巩固

• 在 README 记录安装路径、环境变量、镜像配置、本地仓库路径、构建/运行命令。
• 推到自己的 Git 仓库，截图提交记录与远程链接。
• POM 添加 lombok 依赖，重新 mvn compile 验证编译通过。