说实话，作为一名Android开发者，Zui让人抓狂的时刻莫过于打开一个新项目，或者刚geng新完Studio版本，然后盯着底部的进度条发呆。那个“Resolving dependencies...”或者“Downloading SDK”的提示，简直像是在考验我们的耐心。在国内的网络环境下这种情况简直是家常便饭。有时候，一杯咖啡喝完了进度条还在原地踏步，那种无力感，相信大家dou深有体会。

其实这并不是你的代码有问题，也不是电脑配置太低，纯粹是因为网络这堵“墙”太厚了。Google的hen多服务器资源，比如Gradle插件、SDK组件以及Maven仓库，访问起来那是相当的费劲。今天我们就来好好聊聊怎么通过配置代理和镜像，彻底解决这个让人头秃的问题，让你的开发效率像坐上火箭一样起飞。

为什么我们需要配置代理？

在深入操作之前，我们先得明白原理。Android Studio作为一个强大的IDE，它本身需要联网去检查geng新、下载插件，而且底下的构建工具Gradle也需要去拉取各种依赖库。Ru果你没有Zuo任何特殊处理，这些请求通常会直连Google的服务器。结果嘛，自然是超时、连接失败或者速度慢如蜗牛。

配置代理，本质上就是给这些网络请求找一个“中转站”。通过这个中转站，我们Ke以绕过网络限制，快速地获取到需要的资源。当然除了代理，还有一种geng直接粗暴的方法——使用国内镜像，这个我们后面也会详细讲到。

第一步：搞定Android Studio自身的网络设置

我们得让Android Studio这个“大家伙”Neng连上网。这包括它的插件市场、SDK Manager以及系统geng新功Neng。Ru果这一步没走通，你可Neng连下载Android SDKdou成问题。

进入HTTP Proxy设置界面

打开Android Studio，在顶部菜单栏找到 File 选项。点击它，然后选择 Settings。在弹出的这个巨大设置窗口里别被眼花缭乱的选项吓到了。

我们要找的是 Appearance & Behavior -> System Settings -> HTTP Proxy。这一路点下去，你就Nengkan到代理配置的主界面了。

选择你的代理模式

在这里通常有几种选择。Ru果你在公司内网，或者有自动配置脚本，那么直接选 Auto-detect proxy settings 是Zui省事的。Studio会尝试自动获取你系统当前的代理设置。

但大多数情况下我们还是得手动来。选择 Manual proxy configuration。这时候，你需要填入你代理服务器的信息。这里通常支持HTTP和SOCKS两种协议。

填好Host name和Port number之后千万别忘了点击右下角的 Check connection。输入一个外网地址测试一下。Ru果kan到成功的提示，那就恭喜你，第一步Yi经完成了。点击Apply，AS本身的网络问题就解决了。

第二步：Gradle构建系统的代理配置

你以为搞定上面那一步就万事大吉了吗？太天真了。Android StudioNeng上网了不代表你的项目就Neng编译通过。Gradle是个独立的构建工具，它有自己的一套网络逻辑。hen多时候，你会发现IDENeng下载插件，但Sync项目时依然报错，这就是Gradle在作怪。

Gradle的代理配置，Zui推荐的方式是修改 gradle.properties 文件。这个文件既Ke以是全局的，也Ke以是项目局部的。为了不影响其他项目，我通常建议直接在项目的 gradle.properties 里添加。

添加基础代理参数

打开文件，你需要添加类似下面这样的配置。注意，这里的属性名是以 systemProp 开头的，这是告诉JVM在运行时设置这些系统属性。

systemProp.http.proxyHost=你的代理IP
systemProp.http.proxyPort=你的代理端口
systemProp.https.proxyHost=你的代理IP
systemProp.https.proxyPort=你的代理端口

把上面的“你的代理IP”和“端口”替换成你实际的信息。Ru果你的代理是HTTP类型的，这样配置通常就够用了。但是Ru果你的代理服务器需要账号密码验证，那还得再加把料。

处理认证信息

有些代理服务比较严格，不让你白嫖。这时候，你需要把用户名和密码也写进去。虽然明文密码放在这里有点不太安全，但在本地开发环境下为了Neng跑起来这也是没办法的办法。

systemProp.http.proxyUser=你的用户名
systemProp.http.proxyPassword=你的密码
systemProp.https.proxyUser=你的用户名
systemProp.https.proxyPassword=你的密码

排除不需要代理的地址

还有一个hen实用的技巧。有些地址，比如局域网的Maven库，或者localhost，走代理反而会变慢甚至连不上。这时候，我们Ke以配置 nonProxyHosts。

systemProp.http.nonProxyHosts=localhost|127.0.0.1|*.example.com
systemProp.https.nonProxyHosts=localhost|127.0.0.1|*.example.com

配置完这些，重新Sync一下项目，你会发现Gradle依赖下载的速度有了质的飞跃。那些原本红色的报错，应该dou消失不见了。

第三步：使用国内镜像源

虽然代理Neng解决问题，但有时候代理本身也不稳定，或者速度忽快忽慢。对于国内的开发者来说其实有一张“王牌”——镜像源。特别是阿里云和腾讯云的镜像，那是相当的好用。

使用镜像的原理hen简单：原本要去Google的仓库拉取的jar包，现在直接去国内的服务器拉取，速度自然快如闪电。而且，配置镜像通常不需要复杂的代理设置，直接改仓库地址就行。

配置Maven仓库地址

你需要修改项目中的 build.gradle 或者新版本项目中的 settings.gradle 文件。找到 repositories 这个代码块。

通常，我们会把镜像地址放在Zui前面。Gradle在拉取依赖时是按顺序查找的，一旦在第一个仓库找到了就不会再去后面的仓库找了。所以把阿里云放在 google 和 mavenCentral 前面是关键。

repositories {
    // 阿里云镜像配置，放在Zui前面优先使用
    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://maven.aliyun.com/repository/central' }
    maven { url 'https://maven.aliyun.com/repository/public' }
    // 原始仓库作为兜底
    google
    mavenCentral
}

这样配置之后绝大多数常用的依赖库dou会直接从阿里云的高速通道下载下来。那种kan着进度条“嗖嗖”往前跑的感觉，真的太爽了。

第四步：解决Gradle Wrapper下载慢的问题

除了依赖库，还有一个经常被忽视的“坑”——Gradle Wrapper本身。当你打开一个新项目，或者切换了Gradle版本时Gradle Wrapper会尝试去下载对应版本的Gradle压缩包。这个文件通常有好几十兆，而且默认也是从国外的服务器下载，经常卡死。

这时候，我们需要手动干预一下。打开项目目录下的 gradle/wrapper/gradle-wrapper.properties 文件。

你会kan到有一行 distributionUrl。我们需要把这里的域名替换成腾讯云的镜像地址。

比如原地址可Neng是这样的：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip

你Ke以把它改成：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.5-bin.zip

改完之后记得点击IDE右上角的“Sync Now”或者“Reload Gradle Projects”。这时候，Gradle Wrapper的下载速度应该就Neng起飞了。

一些常见坑点与经验之谈

折腾了这么多年的开发环境，我也踩过不少坑。这里顺便分享几个小经验，希望Neng帮你省点时间。

关于SOCKS代理。虽然Android Studio的HTTP Proxy设置里支持SOCKS，但在Gradle中使用SOCKS代理有时候会出奇地不稳定，经常出现连接中断或者SSL错误。Ru果Ke以的话，尽量把你的代理工具开启HTTP代理端口，然后在Gradle里配置HTTP代理，通常会geng稳一些。

关于配置的位置。Ru果你不想每个项目dou改一遍 gradle.properties，那就把它放到用户的主目录下。在Windows上通常是 C:\Users\你的用户名\.gradle\gradle.properties，在Mac上是 ~/.gradle/gradle.properties。这里配置的属性对所有项目dou生效，一劳永逸。

Zui后别忘了检查防火墙。有时候配置dou对了依然连不上，可Neng是Windows防火墙或者杀毒软件在背后“搞鬼”。把Java进程或者Gradle进程加到白名单里也许就Neng解决莫名其妙的连接问题。

配置Android Studio的代理和镜像，虽然听起来有点繁琐，但这绝对是每个Android开发者必须掌握的生存技Neng。无论是通过HTTP Proxy打通网络通道，还是利用阿里云、腾讯云镜像实现内网加速，目的dou是为了让我们geng专注于代码本身，而不是在等待下载中浪费生命。

希望这篇指南Neng帮你彻底解决网络困扰。当你下次kan到Sync瞬间完成，构建一气呵成的时候，别忘了回来给这篇文章点个赞。毕竟时间就是金钱，而谁又愿意把时间浪费在转圈圈上呢？祝大家开发愉快，Bug全消！

---