Android Studio 代理配置指南

Android 项目开发中，主要需要配置 Android Studio 工具代理和 Gradle 代理，确保 SDK 下载、插件更新、依赖拉取等网络请求正常。

1. Android Studio HTTP Proxy

配置路径：Settings → Appearance & Behavior → System Settings → HTTP Proxy

选择 Manual proxy configuration，填写代理信息：

字段	示例值
Host name	`127.0.0.1`
Port number	`7890`

勾选 Auto-detect proxy settings 或手动指定，配置后 AS 自身的 SDK Manager、插件市场等都会走代理。

2. Gradle Proxy

在全局或项目的 gradle.properties 中添加代理配置：

全局配置文件路径：

系统	路径
macOS / Linux	`~/.gradle/gradle.properties`
Windows	`C:\Users\用户名\.gradle\gradle.properties`

配置内容：

properties 复制代码

systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890

如果代理需要认证，追加：

properties 复制代码

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

如需排除某些地址不走代理：

properties 复制代码

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

配置完成后，Gradle Wrapper 下载、Maven 依赖拉取（google()、mavenCentral()）均会通过代理访问。

3. Maven 仓库镜像（可选）

代理稳定时无需配置。当代理不稳定或希望加快依赖下载速度时，可将仓库替换为国内镜像。

在 settings.gradle 或 build.gradle 的 repositories 中配置：

groovy 复制代码

repositories {
    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()
}

镜像源放在原始源前面，Gradle 会优先从镜像拉取，拉不到再回退到原始源。

常用阿里云镜像地址：

镜像地址	对应源
`https://maven.aliyun.com/repository/google`	Google Maven
`https://maven.aliyun.com/repository/central`	Maven Central
`https://maven.aliyun.com/repository/public`	Central + JCenter 聚合
`https://maven.aliyun.com/repository/gradle-plugin`	Gradle 插件

4. Gradle 分发镜像（可选）

下载 Gradle 本体较慢时，可修改 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl，将域名替换为腾讯镜像：

properties 复制代码

# 原始地址
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

# 腾讯镜像
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.7-bin.zip

配置总览

配置项	是否必须	说明
AS HTTP Proxy	必须	SDK、插件、工具下载
Gradle Proxy（`gradle.properties`）	必须	Gradle Wrapper + 依赖下载
Maven 仓库镜像（`build.gradle`）	可选	代理不稳定或追求速度时配置
Gradle 分发镜像（`gradle-wrapper.properties`）	可选	Gradle 本体下载慢时配置