Android Studio中配置Maven本地仓库路径需修改settings.xml的节点为绝对路径(如D:/android-m2-repo),并确保Settings中“User settings file”指向该文件;还可通过gradle.properties或build.gradle单独指定项目级路径。

在Android Studio项目中为Maven仓库配置本地路径,是为了避免依赖默认下载到C盘用户目录下的.m2/repository,防止磁盘空间被快速占满,同时提升多项目共享依赖的效率。
修改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,在<settings>标签内找到<localRepository>节点(若不存在则手动添加),将其值设为绝对路径,例如:<localRepository>D:/android-m2-repo</localRepository>
【路径必须用正斜杠/或双反斜杠\,单反斜杠会导致解析失败】
第四步:保存文件,重启Android Studio。新创建或同步的Gradle项目将自动使用该路径作为本地仓库根目录。
验证本地仓库是否生效
执行任意一次Gradle sync或运行./gradlew build后,检查你指定的路径(如D:/android-m2-repo)是否生成了org/apache/maven等子目录结构。
若目录为空或仍向C:UsersXXX.m2
epository写入,则说明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全局本地仓库机制,且无法跳过远程仓库校验。


















