Appearance
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
- 访问 Maven 官方网站:https://maven.apache.org/download.cgi
- 选择最新版本的 Maven 二进制压缩包(如 apache-maven-3.8.8-bin.zip 或 apache-maven-3.8.8-bin.tar.gz)
- 下载到本地计算机
步骤 2:安装 Maven
Windows 系统
- 解压下载的压缩包到一个目录,例如
C:\Program Files\Apache\Maven - 确保解压后的目录结构正确,应该包含
bin、conf、lib等子目录
Linux/macOS 系统
- 解压下载的压缩包到一个目录,例如
/usr/local/apache-maven - 使用命令
tar -xvf apache-maven-3.8.8-bin.tar.gz解压
2.3 环境变量配置
Windows 系统
- 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」中,点击「新建」,添加以下环境变量:
- 变量名:
MAVEN_HOME - 变量值:Maven 安装目录,例如
C:\Program Files\Apache\Maven\apache-maven-3.8.8
- 变量名:
- 编辑
Path环境变量,在末尾添加;%MAVEN_HOME%\bin - 点击「确定」保存所有更改
Linux/macOS 系统
- 打开终端
- 编辑
~/.bashrc或~/.zshrc文件(根据使用的 shell 而定) - 添加以下内容:bash
export MAVEN_HOME=/usr/local/apache-maven/apache-maven-3.8.8 export PATH=$PATH:$MAVEN_HOME/bin - 保存文件并执行
source ~/.bashrc或source ~/.zshrc使配置生效
2.4 验证安装
- 打开命令行终端
- 执行命令
mvn -version - 如果安装成功,会显示 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 主要配置项
本地仓库位置:
xml<localRepository>/path/to/local/repo</localRepository>远程仓库:
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>镜像仓库:
xml<mirrors> <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror> </mirrors>代理设置:
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>配置文件:
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 的构建效率和可靠性。