Maven默认本地仓库路径为${user.home}/.m2/repository，修改方法是在%USERPROFILE%.m2\settings.xml（Windows）或~/.m2/settings.xml（Linux/macOS）的标签内添加绝对路径，保存后新项目即生效。
怎么改 Maven 默认本地仓库路径
默认情况下，Maven 把下载的 jar 包全扔在用户主目录下的 .m2/repository 里。如果磁盘空间小、或想统一管理多个项目的依赖，就得换地方。
改法很简单：编辑或新建 ~/.m2/settings.xml（Windows 是 %USERPROFILE%\.m2\settings.xml），在 <settings></settings> 标签下加一行：
<localRepository>/path/to/your/local/repo</localRepository>
注意：settings.xml 文件本身可能不存在，得手动创建；路径别用 ~，要用绝对路径，比如 Linux 下写 /home/you/m2-repo，Windows 下写 C:\maven\repo。
- 改完后所有新项目自动生效，但已有项目不会自动迁移旧包——要手动复制或清空重下
- IDE（如 IntelliJ）可能缓存旧路径，改完需重启或刷新 Maven 项目
- 别把本地仓库放在 NFS 或网络盘上，I/O 延迟会导致构建卡顿甚至失败
怎么让 Maven 优先从公司私服拉包
公司搭了 Nexus 或 Artifactory，但你的项目还是去中央仓库（https://repo.maven.apache.org/maven2）下载，说明私服没配进 settings.xml 的 <mirrors></mirrors> 里。
立即学习“Java免费学习笔记（深入）”；
关键不是加一个 <repository></repository> 到 pom.xml，而是全局镜像——这样连插件、父 POM 都能走私服：
<mirrors>
<mirror>
<id>company-nexus</id>
<mirrorOf>*</mirrorOf>
<url>https://nexus.example.com/repository/maven-public/</url>
</mirror>
</mirrors>
<mirrorof>*</mirrorof> 表示拦截所有仓库请求；如果只想镜像中央仓库，写 central；如果同时用多个私服，不能都设为 *，得用 external:* 或具体 ID 排除。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 私服地址末尾的
/repository/xxx/路径必须准确，少个斜杠或写错仓库名会返回 404，但 Maven 默认只报 “Could not transfer artifact”，不提示真实 URL 错在哪 - 私服若启用了认证，必须在
settings.xml的<servers></servers>段落配好<server></server>，且<id></id>必须和<mirror></mirror>的<id></id>一致 - 某些老版本 Maven（如 3.0.x）对
mirrorOf解析有 bug，遇到奇怪的跳转失败，先升级到 3.6.3+ 再排查
为什么 mvn clean install 还是连不上私服？
常见现象：配置写了，settings.xml 也放对位置了，但执行命令时日志里还是出现 Downloading from central:，或者直接报 Connection refused。
优先检查三件事：
- 运行
mvn -X clean install（开启 debug 日志），搜Using connector和Downloading from，看实际用的是哪个mirror或repository - 确认
settings.xml真正被读取：执行mvn help:effective-settings，输出里能看到你写的localRepository和mirrors才算生效 - 检查是否被项目级
settings.xml覆盖：Maven 会按顺序加载MAVEN_HOME/conf/settings.xml→USER_HOME/.m2/settings.xml，后者优先级更高，但如果你在项目根目录放了.mvn/maven.config并指定-s参数，那就以它为准
还有一个隐蔽点：某些 CI 环境（如 Jenkins）会用自己的 settings.xml，本地配得再好也没用，得去流水线脚本里找 -s 参数或“Global Maven Configuration”设置。
私服仓库类型选 proxy 还是 hosted？
这问题不直接影响 settings.xml 配置，但关系到你拉包是否稳定、上传是否成功。Nexus 里常见的三种仓库类型中，proxy（代理远程源）、hosted（托管自有构件）、group（聚合多个仓库）必须组合使用才合理。
典型做法是：建一个 group 类型仓库（比如叫 maven-public），把它设为 mirrorOf 目标；然后把公司的 hosted（放内部 SDK）、中央仓库的 proxy（如 maven-central）、甚至 JCenter 的 proxy 全部加进这个 group。
- 只配
proxy仓库地址给开发用，会导致无法发布 SNAPSHOT 或 RELEASE 构件——因为proxy不支持写入 - 如果
settings.xml里<mirrorof></mirrorof>指向的是单个hosted仓库，那所有依赖都会 404，除非你手动把所有外部包都上传进去 - Group 仓库的顺序很重要：内部
hosted放最前，确保同名 artifact 优先取内部版本；proxy 放后面兜底
复杂点在于，不同团队可能需要隔离依赖源（比如测试环境禁用 snapshot），这时就得建多个 group，再通过不同 settings.xml 或 profile 切换——但那是另一层配置了。
