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 |
配置内容：
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890
如果代理需要认证，追加：
systemProp.http.proxyUser=用户名
systemProp.http.proxyPassword=密码
systemProp.https.proxyUser=用户名
systemProp.https.proxyPassword=密码
如需排除某些地址不走代理：
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 中配置：
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，将域名替换为腾讯镜像：
# 原始地址
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 本体下载慢时配置 |
