Android Studio 代理配置指南

Android 项目开发中主要需要配置 Android Studio 工具代理和 Gradle 代理确保 SDK 下载、插件更新、依赖拉取等网络请求正常。1. Android Studio HTTP Proxy配置路径Settings → Appearance Behavior → System Settings → HTTP Proxy选择Manual proxy configuration填写代理信息字段示例值Host name127.0.0.1Port number7890勾选Auto-detect proxy settings或手动指定配置后 AS 自身的 SDK Manager、插件市场等都会走代理。2. Gradle Proxy在全局或项目的gradle.properties中添加代理配置全局配置文件路径系统路径macOS / Linux~/.gradle/gradle.propertiesWindowsC:\Users\用户名\.gradle\gradle.properties配置内容systemProp.http.proxyHost127.0.0.1 systemProp.http.proxyPort7890 systemProp.https.proxyHost127.0.0.1 systemProp.https.proxyPort7890如果代理需要认证追加systemProp.http.proxyUser用户名 systemProp.http.proxyPassword密码 systemProp.https.proxyUser用户名 systemProp.https.proxyPassword密码如需排除某些地址不走代理systemProp.http.nonProxyHostslocalhost|127.0.0.1|*.example.com systemProp.https.nonProxyHostslocalhost|127.0.0.1|*.example.com配置完成后Gradle Wrapper 下载、Maven 依赖拉取google()、mavenCentral()均会通过代理访问。3. Maven 仓库镜像可选代理稳定时无需配置。当代理不稳定或希望加快依赖下载速度时可将仓库替换为国内镜像。在settings.gradle或build.gradle的repositories中配置repositories{maven{urlhttps://maven.aliyun.com/repository/google}maven{urlhttps://maven.aliyun.com/repository/central}maven{urlhttps://maven.aliyun.com/repository/public}google()mavenCentral()}镜像源放在原始源前面Gradle 会优先从镜像拉取拉不到再回退到原始源。常用阿里云镜像地址镜像地址对应源https://maven.aliyun.com/repository/googleGoogle Mavenhttps://maven.aliyun.com/repository/centralMaven Centralhttps://maven.aliyun.com/repository/publicCentral JCenter 聚合https://maven.aliyun.com/repository/gradle-pluginGradle 插件4. Gradle 分发镜像可选下载 Gradle 本体较慢时可修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl将域名替换为腾讯镜像# 原始地址 distributionUrlhttps\://services.gradle.org/distributions/gradle-8.7-bin.zip # 腾讯镜像 distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-8.7-bin.zip配置总览配置项是否必须说明AS HTTP Proxy必须SDK、插件、工具下载Gradle Proxygradle.properties必须Gradle Wrapper 依赖下载Maven 仓库镜像build.gradle可选代理不稳定或追求速度时配置Gradle 分发镜像gradle-wrapper.properties可选Gradle 本体下载慢时配置