在 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,在 标签内找到 节点(如果不存在,就手动添加一个)。把它的值设为一个绝对路径,比如:
注意:路径必须用正斜杠 / 或双反斜杠 \\,单反斜杠 \ 会导致解析失败,这个坑很多新手踩过。
第四步:保存文件,然后重启 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 的全局本地仓库机制。而且,它无法跳过远程仓库的校验,如果远程仓库不可用,依赖还是会报错。所以,如果想彻底控制依赖缓存位置,还是优先用全局配置的方法。
