安卓Maven仓库本地配置入口完整设置步骤教程

在 Android Studio 中配置 Maven 本地仓库，很多开发者都遇到过这样的尴尬：默认的依赖缓存全挤在 C 盘用户目录下的 .m2/repository，项目一多，几十 GB 的磁盘空间说没就没。更糟的是，如果是多人协作，每个人还得各自下载一遍，效率低不说，还占空间。其实，只要改一下路径，就能一劳永逸——既能避免 C 盘爆炸，又能让多项目共享依赖，省时省力。

修改 Android Studio 全局 Maven 本地仓库路径

具体操作分四步走，跟着来就行：

第一步：打开 Android Studio，进入 File → Settings（Windows/Linux）或 Android Studio → Preferences（macOS），然后找到 Build, Execution, Deployment → Build Tools → Maven。

第二步：在右侧的“User settings file”栏，点击“…”按钮，定位到你想要使用的 settings.xml 文件。如果还没创建这个文件，直接点击“Create settings.xml”就能自动生成一个。

第三步：用文本编辑器打开这个 settings.xml，在 标签内找到 节点（如果不存在，就手动添加一个）。把它的值设为一个绝对路径，比如：D:/android-m2-repo

注意：路径必须用正斜杠 / 或双反斜杠 \\，单反斜杠 \ 会导致解析失败，这个坑很多新手踩过。

第四步：保存文件，然后重启 Android Studio。之后新建或同步的 Gradle 项目会自动使用这个路径作为本地仓库的根目录。

验证本地仓库是否生效

方法很简单：执行一次 Gradle sync，或者运行 ./gradlew build，然后去你指定的路径（比如 D:/android-m2-repo）看看，有没有生成类似 org/apache/maven 这样的子目录结构。如果目录空空的，或者发现依赖仍然往 C:UsersXXX.m2repository 里写，那说明 settings.xml 没有被正确加载。

这时候需要检查一下：Android Studio 中 Maven 设置页的“User settings file”路径，指向的是不是你刚编辑的那个文件？别让它还指向默认的 %USER_HOME%/.m2/settings.xml，否则一切白费。

为单个 Android 项目强制指定本地仓库（可选）

有时候你可能只想让某个特定项目使用不同的仓库路径，而不影响全局设置。有两种方式：

方法一：在项目根目录的 gradle.properties 里添加一行：maven.repo.local=D:/my-android-repo

方法二：在模块级 build.gradle 的 repositories 块中显式声明一个本地仓库：maven { url uri("D:/my-android-repo") }

不过要提醒一句：这种方式只影响当前模块的依赖查找顺序，并不能替代 Maven 的全局本地仓库机制。而且，它无法跳过远程仓库的校验，如果远程仓库不可用，依赖还是会报错。所以，如果想彻底控制依赖缓存位置，还是优先用全局配置的方法。