settings.xml 是 Maven 的全局配置文件,用于配置仓库镜像、私有仓库、认证凭据等;优先加载用户级 ${user.home}/.m2/settings.xml;常用场景包括通过 mirrors 配置阿里云镜像、用 profiles 启用 Nexus 私服、在 servers 中配认证信息且 id 必须一致。
settings.xml 是 Maven 的配置文件,用于控制构建行为、仓库地址、认证凭据、代理等。它不定义项目本身(那是 pom.xml 的职责),而是影响所有使用该 Maven 实例的项目——换句话说,它是“全局”或“用户级”的行为开关。
settings.xml 的位置和优先级
Maven 会按顺序加载两个 settings.xml 文件,后加载的覆盖前一个的同名配置:
- 全局配置:
${maven.home}/conf/settings.xml(对所有用户生效,需管理员权限修改) - 用户配置:
${user.home}/.m2/settings.xml(推荐使用,无需权限,且不会被 Maven 升级覆盖)
绝大多数场景下,你应该只编辑用户级的 ${user.home}/.m2/settings.xml。如果该文件不存在,可手动创建,或从 ${maven.home}/conf/settings.xml 复制一份作为起点。
用 mirrors 配置国内镜像仓库(最常用场景)
默认中央仓库(https://repo.maven.apache.org/maven2/)在国内访问慢且不稳定。通过 节点可将所有对中央仓库的请求重定向到镜像源,比如阿里云 Maven 仓库。
在 settings.xml 的 标签下添加:
aliyunmaven central Aliyun Maven https://maven.aliyun.com/repository/public
注意关键点:
-
central表示该镜像仅替换 ID 为central的仓库(即默认中央仓库) - 不要写成
*,否则可能意外拦截私有仓库或插件仓库 - 多个
时,Maven 只取第一个匹配项,顺序很重要
用 profiles + activeProfiles 启用自定义仓库(如 Nexus 私服)
如果你公司内部部署了 Nexus 或 Artifactory,需要显式声明并启用它,不能靠 mirrors 简单覆盖(因为私服通常不是 central 的镜像,而是独立坐标空间)。