清晰易懂的Maven安装教程（含自定义依赖包位置）

初学者也能看懂的 Maven 安装教程（含自定义依赖包位置）

Maven 是一个强大的项目管理和构建工具，广泛用于 Java 项目的依赖管理和构建自动化。本教程将手把手教你如何在 Windows 系统上安装 Maven，并配置环境变量，同时设置 Maven 下载依赖包的位置到其他目录。即使你是初学者，也能轻松学会！

一、准备工作

1. 操作系统：Windows 10 或更高版本。
2. Java 环境：确保已经安装 JDK（Java Development Kit），并配置好环境变量。
   • 如果没有安装 JDK，可以参考 Java 8 安装教程。
3. 下载工具：一个浏览器（如 Chrome、Edge）。
4. 存储空间：确保你的电脑有至少 100MB 的可用空间。

二、下载 Maven

1. 打开浏览器，访问 Maven 的官方下载页面：
   • Maven 下载页面
2. 选择适合的版本：
   • 下载最新的二进制压缩包（如 apache-maven-3.9.5-bin.zip）。
3. 下载完成后，找到下载的压缩包（通常在“下载”文件夹中）。

三、安装 Maven

1. 解压压缩包：
   • 右键点击压缩包，选择“解压到当前文件夹”或“解压到 apache-maven-3.9.5”。
   • 解压后会得到一个文件夹（如 apache-maven-3.9.5）。
2. 移动文件夹：
   • 将解压后的文件夹移动到一个合适的目录（如 C:\Program Files\ 或 D:\Maven）。

四、配置环境变量

为了让电脑知道 Maven 的安装位置，需要配置环境变量。以下是详细步骤：

1. 打开环境变量设置

1. 右键点击“此电脑”或“我的电脑”，选择“属性”。
2. 点击“高级系统设置”。
3. 在“系统属性”窗口中，点击“环境变量”。

2. 设置 MAVEN_HOME

1. 在“系统变量”区域，点击“新建”。
2. 输入以下内容：
   • 变量名：MAVEN_HOME
   • 变量值：Maven 的安装路径（如 C:\Program Files\apache-maven-3.9.5）。
3. 点击“确定”。

3. 配置 Path 变量

1. 在“系统变量”区域，找到 Path，点击“编辑”。
2. 点击“新建”，输入以下内容：
   • %MAVEN_HOME%\bin
3. 点击“确定”保存。

4. 验证配置

1. 打开命令提示符：
   • 按 Win + R，输入 cmd，按回车。
2. 输入以下命令：
   • mvn -version
   • 如果显示类似以下内容，说明配置成功：

     Apache Maven 3.9.5 (...)
     Maven home: C:\Program Files\apache-maven-3.9.5
     Java version: 1.8.0_381, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk1.8.0_381\jre
     Default locale: zh_CN, platform encoding: GBK
     OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"
     

五、设置 Maven 依赖包下载位置

默认情况下，Maven 会将下载的依赖包存储在用户目录下的 .m2/repository 文件夹中（如 C:\Users\<你的用户名>\.m2\repository），此位置会随着下载的依赖包占用较大存储空间。如果你希望将依赖包存储到其他位置，可以按照以下步骤配置：

1. 创建自定义仓库目录

• 在你希望的位置创建一个文件夹（如 D:\MavenRepository）。

2. 修改 Maven 配置文件

• 打开 Maven 的配置文件（如 C:\Program Files\apache-maven-3.9.5\conf\settings.xml）。
• 找到 <localRepository> 标签，如果没有则添加以下内容：

  <settings>
    <localRepository>D:\MavenRepository</localRepository>
  </settings>
  

• 保存文件。

3. 验证配置

• 打开命令提示符，输入以下命令创建一个 Maven 项目：

  mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
  

• 检查 D:\MavenRepository 目录下是否有依赖包下载。

六、使用 Maven 创建第一个项目

1. 创建项目：

   • 打开命令提示符，进入你希望创建项目的目录（如 cd D:\Projects）。
   • 输入以下命令创建一个 Maven 项目：

     mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
     

   • 命令解释：
     • -DgroupId：项目的组织标识（如 com.example）。
     • -DartifactId：项目的名称（如 my-app）。
     • -DarchetypeArtifactId：项目模板（这里使用 maven-archetype-quickstart，即快速启动模板）。
     • -DinteractiveMode=false：禁用交互模式，直接生成项目。

2. 进入项目目录：

   • 输入以下命令进入项目目录：

     cd my-app
     

3. 编译项目：

   • 输入以下命令编译项目：

     mvn compile
     

4. 运行项目：

   • 输入以下命令运行项目：

     mvn exec:java -Dexec.mainClass="com.example.App"
     

   • 如果看到输出 Hello World!，说明你的 Maven 项目已经成功运行！

七、常见问题

1. mvn 命令找不到：

   • 确保环境变量配置正确，尤其是 MAVEN_HOME 和 Path。
   • 如果仍然报错，尝试重启电脑。

2. 项目创建失败：

   • 确保网络连接正常，Maven 需要从远程仓库下载依赖。
   • 如果下载速度慢，可以配置国内镜像源（如阿里云镜像）：
     1. 打开 Maven 的配置文件（如 C:\Program Files\apache-maven-3.9.5\conf\settings.xml）。
     2. 在 <mirrors> 标签中添加以下内容：

        <mirror>
          <id>aliyunmaven</id>
          <mirrorOf>*</mirrorOf>
          <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
        

3. Java 版本不兼容：

   • 确保安装的 JDK 版本与 Maven 兼容（Maven 3.3+ 需要 JDK 1.7 或更高版本）。

八、总结

通过本教程，你已经成功安装了 Maven，并配置了环境变量，同时设置了自定义的依赖包下载位置，还创建并运行了第一个 Maven 项目！接下来，你可以继续学习 Maven 的高级用法（如多模块项目、插件配置等）。

如果有任何问题，欢迎随时查阅相关文档或向社区求助。祝你编程愉快！ 🚀