先装 Maven 并配置 PATH：Mac/Linux 用 brew install maven，Windows 用 SDKMAN!；再改本地仓库路径至非 C 盘/桌面（如 D:\maven\repo），并正确配置 settings.xml 中 mirrorOf 为 * 或 central。
mvn 命令报 “command not found” 怎么办
说明：这代表系统根本没识别到 Maven，不是配置错了，是压根没装好或没加进 PATH。
实操建议：
立即学习“Java免费学习笔记（深入）”；
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- Mac/Linux 下用
brew install maven最稳；Windows 推荐用SDKMAN!（运行sdk install maven），比手动解压配环境变量出错率低得多 - 手动下载二进制包后，必须把
apache-maven-x.x.x/bin路径加进PATH，不是只加apache-maven-x.x.x根目录 - 验证是否生效：新开终端，执行
which mvn（Mac/Linux）或where mvn（Windows），有输出才真成功
本地仓库路径怎么改，为什么不能放 C 盘或桌面
说明：Maven 默认把所有 jar 包下到 ~/.m2/repository，但这个位置常被 IDE、CI 或多用户共享干扰，必须主动调整。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 修改
conf/settings.xml中的<localrepository></localrepository>，比如设为/opt/m2-repo（Mac/Linux）或D:\maven\repo（Windows） - 别放 C 盘根目录或桌面：Windows 下权限控制严，
mvn clean install可能因 UAC 弹窗中断；桌面路径含空格或中文会触发java.io.IOException: invalid header field - 改完后首次运行
mvn help:system，检查输出里的maven.repo.local是否已更新
settings.xml 放哪才生效：全局 vs 用户级优先级
说明：Maven 会按顺序加载多个 settings.xml，位置错了，你改的镜像源、认证信息全白配。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用户级配置（推荐）：放在
~/.m2/settings.xml，覆盖默认值，不影响其他用户 - 全局配置（慎用）：放在
$M2_HOME/conf/settings.xml，所有用户共用，CI 环境里容易误踩坑 - 命令行可临时指定：
mvn -s /path/to/custom-settings.xml compile，适合调试镜像源是否生效 - 注意：如果两个位置都存在，用户级会覆盖全局配置，但 profile 激活逻辑仍以全局为准，冲突时优先看
activeProfiles所在文件
阿里云镜像源配置后 still downloading from central
说明：这不是网络问题，是 mirrorOf 写法不匹配，Maven 根本没把请求转发过去。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 必须写成
<mirrorof>*</mirrorof>或<mirrorof>central</mirrorof>，不能写<mirrorof>https://repo.maven.apache.org</mirrorof>—— Maven 不按 URL 匹配 - 检查是否被 profile 覆盖：如果
settings.xml里有<profiles></profiles>且启用了某个 profile，而该 profile 里没定义<mirrors></mirrors>，那镜像就失效 - 验证方法：执行
mvn help:effective-settings，搜mirrors，确认输出中mirrorOf是*且url是https://maven.aliyun.com/repository/public
mvn compile 卡住不动，八成是这两个地方没对上。 
