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 本体下载慢时配置 |
)
