【apache-maven3.9安装与配置】

apache-maven3.9安装与配置

已安装 JDK 8+（推荐 JDK 11/17）

java -version  # 验证Java环境

‌安装步骤

1. 下载 Maven 3.9‌

官网下载地址：
https://maven.apache.org/download.cgi
直接下载（替换为最新版链接）：

wget https://dlcdn.apache.org/maven/maven-3/3.9.8/binaries/apache-maven-3.9.8-bin.tar.gz
# 或者 wget https://dlcdn.apache.org/maven/maven-3/3.9.10/binaries/apache-maven-3.9.10-bin.tar.gz

2. 解压并移动到安装目录‌

tar -xzvf apache-maven-3.9.8-bin.tar.gz
sudo mv apache-maven-3.9.8 /opt/maven

3. 配置环境变量‌

编辑配置文件（以 ~/.bashrc 或 ~/.zshrc 为例）：

nano ~/.bashrc

在文件末尾添加：

export MAVEN_HOME=/opt/maven
export PATH=$PATH:$MAVEN_HOME/bin

使配置生效：

source ~/.bashrc

4. 验证安装‌

mvn -v

成功输出示例：
Apache Maven 3.9.8 (…)
Java version: 1.8.0_421, vendor: Oracle Corporation

配置优化‌

‌1. 镜像加速（国内用户必做）‌

编辑 Maven 配置文件 ~/.m2/settings.xml（若不存在则新建）：

<settings>
  <mirrors>
    <mirror>
      <id>aliyun</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
</settings>

‌2. 自定义本地仓库位置（可选）‌

修改 ~/.m2/settings.xml：

<settings>
  <localRepository>/path/to/your/local/repo</localRepository>
</settings>

‌3. 配置 IDE 中的 Maven‌

‌IntelliJ IDEA‌：
Preferences > Build, Execution, Deployment > Build Tools > Maven
‌Eclipse‌：
Windows > Preferences > Maven > User Settings

常见问题解决‌

‌mvn: command not found‌

检查环境变量路径是否正确
确保执行了 source ~/.bashrc

‌依赖下载失败‌

检查镜像配置是否正确
尝试清理本地仓库：mvn dependency:purge-local-repository

JDK 版本不兼容‌

确保 JAVA_HOME 指向 JDK 8+
在 Maven 中指定 JDK 版本：

<profile>
  <id>jdk-17</id>
  <activation><activeByDefault>true</activeByDefault></activation>
  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>
</profile>

验证项目构建

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

生成 target/my-app-1.0-SNAPSHOT.jar 即表示成功