VSCode本身不内置Maven，依赖下载慢主因是其调用的Maven未配置国内镜像或本地仓库位置不当；需通过mvn -v和echo $M2_HOME确认实际使用的Maven路径及settings.xml位置，再在对应<mirrors>中设<mirrorOf>*</mirrorOf>并填正确阿里云地址（带尾斜杠），最后重载pom.xml项目并重启VSCode生效。
VSCode 本身不内置 Maven，依赖下载慢不是 VSCode 的锅，而是它调用的 Maven 进程没走国内镜像、本地仓库又卡在 C 盘——改对 settings.xml 才是关键。
怎么确认 VSCode 正在用哪个 Maven 和 settings.xml
VSCode 的 Java 插件会按优先级找 Maven：先看项目里有没有 -s 参数指定配置文件，再查环境变量 M2_HOME，最后 fallback 到用户目录下的 ~/.m2/settings.xml。但很多情况下，它实际读的是嵌入式 Maven（比如通过 “Extension Pack for Java” 自动下载的版本），路径藏得深：
- Windows：
%USERPROFILE%\.m2\wrapper\dists\apache-maven-3.9.6\...\conf\settings.xml - macOS/Linux：
~/.m2/wrapper/dists/apache-maven-3.9.6/.../conf/settings.xml
别只改 ~/.m2/settings.xml 就以为万事大吉——打开 VSCode 终端，运行 mvn -v 和 echo $M2_HOME，对比输出和你改的文件路径是否一致。不一致？说明插件根本没读你改的那个。
settings.xml 里怎么写镜像才真正生效
镜像配置必须放在 <mirrors> 标签下，且 <mirrorOf> 的值决定它拦截哪些仓库请求。常见错误是写成 central 却忽略 Maven 3.9+ 默认启用了 https://repo.maven.apache.org/maven2 以外的其他仓库（如 spring-milestones）。
- 最稳妥写法：
<mirrorOf>*</mirrorOf>—— 拦截所有远程仓库（包括私库），适合纯国内开发 - 保守写法：
<mirrorOf>central</mirrorOf>—— 只覆盖中央仓库，但要求项目没显式声明其他<repository> - 阿里云地址必须带
/结尾：https://maven.aliyun.com/repository/public/，少斜杠会 404
别把镜像块写在注释里，也别留空 <url></url>——Maven 会静默跳过整段配置。
为什么改了镜像还是卡在 downloading…
VSCode 插件触发依赖解析时，并不会自动 reload settings.xml。即使你刚保存了文件，插件仍可能缓存旧配置或复用已启动的后台进程。
- 右键点击项目根目录下的
pom.xml→ 选 Reload project（不是刷新文件图标） - 如果报错
Could not resolve dependencies但命令行mvn compile成功，大概率是插件没继承 shell 环境变量——Windows 用户直接在 VSCode 设置里搜java.maven.path，填绝对路径如C:\apache-maven-3.9.6\bin - 删掉
~/.m2/repository下对应依赖的整个文件夹（比如org/springframework/spring-core），再重载项目，强制重新下载验证镜像是否真起作用
注意：mvn clean compile 在终端跑得通 ≠ VSCode 插件能识别，二者环境隔离是常态。
怎么把 .m2 仓库从 C 盘挪走又不丢历史依赖
<localRepository> 改路径只是告诉 Maven 往哪写新依赖，旧仓库不会自动迁移。C 盘爆满往往是因为重复下载——同一份 jar 被不同 Maven 版本或不同配置分别存了一份。
- 先在
settings.xml里加：<localRepository>D:/maven_repository</localRepository>（路径不能含中文或空格） - 手动把
~/.m2/repository整个文件夹剪切到新位置，再用符号链接还原（Windows 用mklink /J，macOS/Linux 用ln -s），避免插件丢失已有依赖 - SSD 路径优先；如果新盘是机械硬盘，建议额外加 JVM 参数：
MAVEN_OPTS="-Dmaven.artifact.threads=1"，避免多线程 IO 拖垮性能
改完不重启 VSCode？那新路径永远不会被加载——插件只在启动时读一次配置。
