怎么确认配置真的生效了（课程外的补充）#

配完 settings.xml 之后，如果想知道”Maven 最终到底用了哪个本地仓库、哪个镜像”，可以敲这两条命令（本机实跑输出，值会随自己机器变）：

1
mvn help:evaluate -Dexpression=settings.localRepository -DforceStdout
2
mvn help:effective-settings

第一条只打印生效的本地仓库路径，第二条打印整份生效的 settings（能找到自己写的那两段）：

1
A:\develop\maven\apache-maven-3.9.14\mvn_repo        ← localRepository 生效的结果
2

3
  <localRepository>A:\develop\maven\apache-maven-3.9.14\mvn_repo</localRepository>
4
  <mirrors>
5
    <mirror>
6
      <mirrorOf>*</mirrorOf>
7
      <name>阿里云公共仓库</name>
8
      <url>https://maven.aliyun.com/repository/public</url>
9
      <id>aliyunmaven</id>
10
    </mirror>
11
  </mirrors>

这两条输出的意义是”不用去猜配置有没有被读到”：localRepository 显示的不是自己写的目录，就说明位置或标签写错了；mirrors 里看不到自己的镜像，说明 <mirror> 没放进 <mirrors>。

一、知识回顾（读完直接做下面的实践题）#

1. Maven 不用安装程序：解压 apache-maven-3.9.4-bin.zip 到固定目录即可；课程解压到 D:\develop\apache-maven-3.9.4，路径别带中文和空格
2. 解压目录里的四个关键目录：bin（mvn 命令）、conf（settings.xml 配置文件）、lib（Maven 自己的 jar）、boot（引导类库）
3. 安装四步：解压 → 配本地仓库 → 配阿里云私服 → 配环境变量，最后 mvn -v 验证
4. 本地仓库配置：改 conf\settings.xml，<localRepository>D:\develop\apache-maven-3.9.4\mvn_repo</localRepository>；默认值是 ${user.home}/.m2/repository；目录不用提前建，Maven 自己创建
5. 阿里云私服配置：在 <mirrors> 标签里加 <mirror> 子标签，四个子标签是 <id>alimaven</id>、<name>aliyun maven</name>、<url>http://maven.aliyun.com/nexus/content/groups/public/</url>、<mirrorOf>central</mirrorOf>
6. <mirrorOf> 的含义：这个镜像给哪个仓库用——central 就是给中央仓库做镜像（把下载请求换到阿里云），* 表示所有仓库都走它
7. 环境变量：MAVEN_HOME = Maven 的解压目录（不是 bin 目录）；再把 %MAVEN_HOME%\bin 追加进 Path（Path 里原有内容不能删）
8. 验证命令 mvn -v，输出里的关键信息：版本号（课程是 3.9.4）、Maven home（应指向解压目录）、Java version / runtime（Maven 用的 JDK，课程是 17）；它不下载任何东西，是标准的检查动作
9. 配置注意点（PPT 第 25 页）：注意配置信息的位置和标签——<localRepository> 必须是 <settings> 的直接子标签、<mirror> 必须写在 <mirrors> 里、XML 标签区分大小写写错就不生效；settings.xml 也有两个位置：解压目录\conf\settings.xml（全局，课程改这份）和 用户目录\.m2\settings.xml（当前用户）；改完配置或环境变量要重启命令行窗口和 IDEA 才生效
10. 安装包里另外两个文件：阿里云.txt（镜像配置原文）、del.bat（内容是一行 del /s *.lastUpdated，批量删依赖下载失败留下的 .lastUpdated 文件）

二、动手题#

• 2-1 写出 settings.xml 里的两处配置 在练习文件给出的 settings 骨架里补两处配置：

  1. 把本地仓库指到 D:\develop\apache-maven-3.9.4\mvn_repo；
  2. 加一个阿里云私服（镜像中央仓库）：id 叫 alimaven、显示名 aliyun maven、地址 http://maven.aliyun.com/nexus/content/groups/public/。 配置要放在正确的位置和层级上；写完后校验一下这个文件仍然是合法的 XML。 （练习文件 test_24_本地仓库与私服配置.xml 里已经给了 settings 骨架和写作区。）
  提示（先自己想，实在想不出再点开）

  一级 · 思路：两处配置在两个不同的位置——一处和 <mirrors> 平级，一处写在 <mirrors> 里面 二级 · 方法：本地仓库用 <localRepository>（<settings> 的直接子标签）；镜像要用 <mirrors> 包住 <mirror>，<mirror> 里放 <id> / <name> / <url> / <mirrorOf> 四个子标签，<mirrorOf> 写 central 三级 · 骨架：<localRepository>____</localRepository> / <mirrors><mirror><id>____</id><name>____</name><url>____</url><mirrorOf>____</mirrorOf></mirror></mirrors>

  参考答案（做完再点开）

  1
  <settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
  2
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3
            xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
  4
  
  5
      <!-- ① 本地仓库：<settings> 的直接子标签，和 <mirrors> 平级 -->
  6
      <localRepository>D:\develop\apache-maven-3.9.4\mvn_repo</localRepository>
  7
  
  8
      <!-- ② 阿里云私服：写在 <mirrors> 里面 -->
  9
      <mirrors>
  10
          <mirror>
  11
              <id>alimaven</id>
  12
              <name>aliyun maven</name>
  13
              <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
  14
              <mirrorOf>central</mirrorOf>
  15
          </mirror>
  16
      </mirrors>
  17
  
  18
  </settings>

  显示更多显示更少

  检查点：① 每个标签都正确闭合、能作为合法 XML 解析（练习文件可以直接用浏览器打开看有没有报错）；② <localRepository> 不在 <mirrors> 里面；③ <mirror> 的四个子标签一个不少、拼写大小写都对；④ 用 IDEA 的 Settings → Build Tools → Maven 核对，Local repository 应该显示 ...\mvn_repo。

• 2-2 环境变量的配置与验证 写清楚三件事：

  1. 安装 Maven 需要配的两个环境变量分别叫什么、值是什么（第二个变量里怎么引用第一个）；
  2. 配完在命令行里敲什么命令验证，输出里哪两处信息能确认”装好了”；
  3. 如果敲验证命令提示 'mvn' 不是内部或外部命令，你的排查顺序（至少写两条）。 （练习文件 test_24_环境变量与验证.txt 里给了写作区。）
  提示（先自己想，实在想不出再点开）

  一级 · 思路：一个是”告诉系统 Maven 装在哪”，一个是”让系统能找到 mvn 命令”；验证看的是”版本 + 安装路径” 二级 · 方法：变量名是 MAVEN_HOME 和 Path；值分别是解压目录、%MAVEN_HOME%\bin；验证命令 mvn -v；输出里看 Apache Maven 3.9.4 这一行和 Maven home 这一行；排查先想”窗口重启了吗 → 变量名/路径对不对 → bin 加了没” 三级 · 骨架：____ = D:\develop\apache-maven-3.9.4 / Path 追加 ____\bin / 验证命令 ____ -v

  参考答案（做完再点开）

  2-2

  1. 两个环境变量：
     • 新建 MAVEN_HOME = D:\develop\apache-maven-3.9.4（Maven 的解压目录，不要写到 bin）；
     • 在 Path 里追加 %MAVEN_HOME%\bin（%变量名% 引用上面那个变量；Path 原有内容不能删）。
  2. 验证命令：mvn -v。能确认”装好了”的两处信息是 Apache Maven 3.9.4 (...)（版本号那行） 和 Maven home: D:\develop\apache-maven-3.9.4（安装路径那行）；这两行对了说明命令能找到、而且指向的就是自己解压的那份。
  3. 排查顺序（任答两条即可）：① 是不是在旧窗口里敲的——重开一个命令行再试（环境变量只对新窗口生效）；② MAVEN_HOME 是不是写成了 ...\bin 或路径拼错、Path 里是不是漏了 %MAVEN_HOME%\bin；③ 用 echo %MAVEN_HOME%、echo %Path% 看变量到底有没有生效；④ 解压目录里有没有 bin\mvn.cmd（解压不完整就重新解压）；⑤ 实在不行重启电脑再试。