Skip to content

Maven 安装与配置

2.1 系统要求

在安装 Maven 之前,需要确保系统满足以下要求:

  • Java 开发工具包 (JDK):Maven 3.3+ 需要 JDK 1.7 或更高版本
  • 操作系统:Maven 可以在 Windows、Linux、macOS 等任何支持 Java 的平台上运行
  • 内存:建议至少 512MB RAM
  • 磁盘空间:至少需要 100MB 用于 Maven 安装和本地仓库

2.2 下载与安装

步骤 1:下载 Maven

  1. 访问 Maven 官方网站:https://maven.apache.org/download.cgi
  2. 选择最新版本的 Maven 二进制压缩包(如 apache-maven-3.8.8-bin.zip 或 apache-maven-3.8.8-bin.tar.gz)
  3. 下载到本地计算机

步骤 2:安装 Maven

Windows 系统

  1. 解压下载的压缩包到一个目录,例如 C:\Program Files\Apache\Maven
  2. 确保解压后的目录结构正确,应该包含 binconflib 等子目录

Linux/macOS 系统

  1. 解压下载的压缩包到一个目录,例如 /usr/local/apache-maven
  2. 使用命令 tar -xvf apache-maven-3.8.8-bin.tar.gz 解压

2.3 环境变量配置

Windows 系统

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中,点击「新建」,添加以下环境变量:
    • 变量名:MAVEN_HOME
    • 变量值:Maven 安装目录,例如 C:\Program Files\Apache\Maven\apache-maven-3.8.8
  3. 编辑 Path 环境变量,在末尾添加 ;%MAVEN_HOME%\bin
  4. 点击「确定」保存所有更改

Linux/macOS 系统

  1. 打开终端
  2. 编辑 ~/.bashrc~/.zshrc 文件(根据使用的 shell 而定)
  3. 添加以下内容:
    bash
    export MAVEN_HOME=/usr/local/apache-maven/apache-maven-3.8.8
    export PATH=$PATH:$MAVEN_HOME/bin
  4. 保存文件并执行 source ~/.bashrcsource ~/.zshrc 使配置生效

2.4 验证安装

  1. 打开命令行终端
  2. 执行命令 mvn -version
  3. 如果安装成功,会显示 Maven 的版本信息,包括 Maven 版本、Java 版本和操作系统信息

示例输出:

Apache Maven 3.8.8 (4c87b05d9aedce574290d1acc98575ed5eb6cd39)
Maven home: C:\Program Files\Apache\Maven\apache-maven-3.8.8
Java version: 11.0.16, vendor: Oracle Corporation, runtime: C:\Program Files\Java\jdk-11.0.16
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

2.5 配置文件详解

Maven 有两个主要的配置文件:

2.5.1 全局配置文件

全局配置文件位于 Maven 安装目录的 conf/settings.xml,对所有用户生效。

2.5.2 用户配置文件

用户配置文件位于用户主目录的 .m2/settings.xml,只对当前用户生效。如果此文件不存在,可以从全局配置文件复制一份并修改。

2.5.3 主要配置项

  1. 本地仓库位置

    xml
    <localRepository>/path/to/local/repo</localRepository>
  2. 远程仓库

    xml
    <repositories>
      <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
        <releases>
          <enabled>true</enabled>
        </releases>
        <snapshots>
          <enabled>false</enabled>
        </snapshots>
      </repository>
    </repositories>
  3. 镜像仓库

    xml
    <mirrors>
      <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
      </mirror>
    </mirrors>
  4. 代理设置

    xml
    <proxies>
      <proxy>
        <id>example-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>proxy.example.com</host>
        <port>8080</port>
        <username>proxyuser</username>
        <password>proxypass</password>
        <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
      </proxy>
    </proxies>
  5. 配置文件

    xml
    <profiles>
      <profile>
        <id>development</id>
        <activation>
          <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
          <maven.compiler.source>11</maven.compiler.source>
          <maven.compiler.target>11</maven.compiler.target>
        </properties>
      </profile>
    </profiles>

通过合理配置这些选项,可以提高 Maven 的构建效率和可靠性。