当前位置：首页 > news >正文

Maven中的settings.xml文件配置详解

news 2025/10/13 8:28:39

settings.xml是Maven的核心配置文件之一，用于全局配置Maven的行为。它通常位于~/.m2/目录下（用户级配置）或$M2_HOME/conf/目录下（全局配置）。用户级配置会覆盖全局配置。

在这里插入图片描述

基本结构

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><!-- 配置内容 -->
</settings>

主要配置元素详解

1. 本地仓库配置 (localRepository)

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

指定Maven本地仓库的路径，默认在用户目录下的.m2/repository
可以修改为其他路径以节省空间或统一管理

2. 交互模式配置 (interactiveMode)

<interactiveMode>true</interactiveMode>

是否允许Maven与用户交互（如输入参数），默认为true
通常保持默认值

3. 离线模式配置 (offline)

<offline>false</offline>

是否让Maven工作在离线模式，默认为false
设置为true时，Maven不会从远程仓库下载依赖

4. 代理配置 (proxies)

<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|*.example.com</nonProxyHosts></proxy>
</proxies>

配置HTTP代理服务器
可以配置多个代理，通过active字段激活
nonProxyHosts指定不通过代理的主机（用|分隔）

5. 服务器认证配置 (servers)

<servers><server><id>deployment-repo</id><username>deploy-user</username><password>deploy-pass</password><!-- 可选：私钥路径 --><privateKey>/path/to/private/key</privateKey><!-- 可选：私钥密码 --><passphrase>optional-passphrase</passphrase></server>
</servers>

配置部署到远程仓库时的认证信息
id必须与pom.xml中distributionManagement的repository或snapshotRepository的id匹配

6. 镜像配置 (mirrors)

<mirrors><mirror><id>aliyun-maven</id><name>Aliyun Maven Mirror</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror>
</mirrors>

配置仓库镜像
mirrorOf指定镜像适用的仓库ID（如central表示Maven中央仓库）
常用国内镜像：阿里云、华为云、腾讯云等

7. 配置文件激活 (profiles)

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

定义配置文件，可以包含各种配置
通过activation元素可以设置自动激活条件
常用激活条件：jdk、os、property、file等

8. 激活的配置文件 (activeProfiles)

<activeProfiles><activeProfile>jdk-11</activeProfile><activeProfile>artifactory</activeProfile>
</activeProfiles>

手动激活在profiles中定义的配置文件
可以激活多个配置文件

常用配置示例

配置阿里云镜像

<mirrors><mirror><id>aliyunmaven</id><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror><mirror><id>aliyun-google</id><name>阿里云Google镜像</name><url>https://maven.aliyun.com/repository/google</url><mirrorOf>google</mirrorOf></mirror>
</mirrors>

配置JDK 11环境

<profiles><profile><id>jdk-11</id><activation><activeByDefault>true</activeByDefault><jdk>11</jdk></activation><properties><maven.compiler.source>11</maven.compiler.source><maven.compiler.target>11</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties></profile>
</profiles>

配置Nexus私服

<servers><server><id>nexus-releases</id><username>deploy</username><password>deploy123</password></server><server><id>nexus-snapshots</id><username>deploy</username><password>deploy123</password></server>
</servers><profiles><profile><id>nexus</id><repositories><repository><id>nexus</id><url>http://nexus.example.com/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository></repositories><pluginRepositories><pluginRepository><id>nexus</id><url>http://nexus.example.com/repository/maven-public/</url><releases><enabled>true</enabled></releases><snapshots><enabled>true</enabled></snapshots></pluginRepository></pluginRepositories></profile>
</profiles><activeProfiles><activeProfile>nexus</activeProfile>
</activeProfiles>