企业官网建设流程全解析

简介：这份文档面向Android应用开发者，尤其是受网络限制困扰、需要加速SDK组件下载的初中级开发人员，聚焦于在Android Studio的SDK Manager中配置HTTP代理这一常见痛点。内容围绕代理设置的实际操作展开，涵盖自动检测与手动配置两种模式的选择、镜像站点主机与端口的填写方式，以及需要身份验证时的用户名密码处理，并提示代理可同步用于Gradle插件、Google服务框架等依赖的更新，同时提醒根据网络环境变化适时调整或取消代理。资源包仅含1个docx文档，约102KB，轻量易读，适合随查随用。目前已有861人学习下载，说明该主题在开发者群体中具有普遍需求。读者可从中获得清晰的代理配置思路与镜像源选择参考，减少因下载缓慢导致的开发阻塞，提升环境搭建与依赖更新的效率。

1. SDK 设置代理：从 SDK Manager 卡住到镜像源跑通的那一次

第一次在新机器上装 Android SDK，我盯着 SDK Manager 的进度条看了二十分钟，它停在 “Fetching URL” 一动不动，最后弹了个超时。当时以为是网络玄学，重启、换 DNS、关防火墙折腾一圈，问题还在。后来才想明白：SDK Manager 默认走的是海外源，国内直连大包基本靠运气。真正管用的做法不是硬等，而是在 SDK Manager 里把代理指向国内镜像，比如mirrors.neusoft.edu.cn这类站点。这篇记录的就是这套环境怎么装、代理怎么配、配错了怎么救，适合刚搭 Android 开发环境、或者换机器后 SDK 下不动的开发者照着走一遍。

2. 装前把环境列清：Android Studio 版本与 SDK 组件取舍

2.1 先定 Android Studio 版本，别一上来追最新

装 SDK 之前得先把宿主工具定下来，因为 SDK Manager 是随 Android Studio 一起分发的，不同版本的菜单位置和代理行为有差异。我一般选当前稳定版（Stable 通道），不碰 Canary。原因很实际：Canary 的 SDK Manager 偶尔会改代理配置的存储位置，配完重启就丢，排查起来很费时间。安装包从官方页面下，装的时候记住两个路径——IDE 安装目录和 SDK 存放目录，后面配代理和验证都要用到。

安装过程中会问是否导入旧配置，新机器直接选不导入，避免把上一台机器残留的代理设置带进来。装完第一次启动，向导会让你选 SDK 组件，这一步先别急着全勾，只勾基础项，等代理配好再回来补大包，否则又卡在下载上。

2.2 SDK 组件按需勾选，别一次全下

SDK Manager 里的组件分几类：Platform（各 API 级别的系统镜像）、Build-Tools、Platform-Tools、Emulator、以及各种 extras。新手容易全选，结果几十 GB 下到一半断掉，还得重来。我的习惯是先装三样：一个目标 API 的 Platform、对应版本的 Build-Tools、Platform-Tools。模拟器和系统镜像等代理通了再单独下，因为镜像包最大，最考验下载稳定性。

版本对应关系上，Build-Tools 不必追最新，跟项目compileSdk匹配的版本就够。比如项目用 API 34，就装build-tools;34.0.0和platforms;android-34。多装几个版本留着切换也行，但每个都是几百 MB，代理没配好之前纯属给自己添堵。

2.3 确认网络出口和镜像可达性

配代理前先做一次连通性确认，别等配完了才发现镜像本身访问不了。用浏览器或命令行访问镜像站点首页，能出页面说明出口没问题。常见做法是先用curl探一下：

# 探测镜像站点是否可达，-I 只取响应头，-m 设超时避免卡死 curl -I -m 10 http://mirrors.neusoft.edu.cn/

返回200或301/302都算通，返回超时或连接拒绝，说明当前网络到该镜像不通，换一个镜像源再试。这一步的意义是把“网络不通”和“代理配错”分开，后面排错时能少走弯路。镜像站点有 http 和 https 两种入口，端口分别是 80 和 443，配代理时端口要和入口协议对上，这是后面会反复提到的一个坑。

3. 在 SDK Manager 里配代理：菜单路径与参数逐项填

3.1 打开 SDK Manager 的两种入口

入口有两个，效果一样，看习惯。第一种从 IDE 顶部菜单走：Tools→SDK Manager。第二种在欢迎界面或设置里找SDK Manager图标。打开后窗口左侧是 SDK Platforms / SDK Tools / SDK Update Sites 几个标签，代理设置不在这些标签的内容区，而在窗口右上角的齿轮图标里，这点很多人第一次找不到。

点齿轮弹出SDK Manager Settings窗口，里面分几块：SDK 路径、HTTP Proxy、以及一些更新选项。代理配置就在 HTTP Proxy 这一块，下面所有操作都围绕它展开。

3.2 手动代理模式下的 Host 和 Port 怎么填

HTTP Proxy 下有两个单选：Auto-detect proxy settings和Manual proxy configuration。自动检测依赖系统代理配置，多数开发机没配系统级代理，选了也是白选，所以直接选手动。手动模式下填三项：Host、Port、以及可选的认证信息。

Host 填镜像站点的域名，不带http://前缀，也不带路径。比如mirrors.neusoft.edu.cn。Port 按入口协议填：走 http 入口填80，走 https 入口填443。填错端口是最常见的翻车点——域名对、端口错，表现是连接被拒或者一直转圈。

Host: mirrors.neusoft.edu.cn Port: 80

如果镜像要求认证，再填 Username 和 Password；公开镜像一般不需要，留空即可。填完点Apply再点OK，设置才会落盘。只点 OK 不点 Apply 在部分版本上不生效，这个细节我吃过亏。

3.3 代理配置存在哪，为什么重启会丢

SDK Manager 的代理设置会写进用户目录下的配置文件，Linux/macOS 一般在~/.android/下，Windows 在%USERPROFILE%\.android\下。了解这一点是为了排错：如果配完重启 IDE 代理又变回自动检测，多半是这个目录权限不对，或者被别的工具覆盖了。

# 查看 .android 目录下与代理相关的配置文件 ls -la ~/.android/

看到配置文件存在但内容没更新，说明写入失败，检查目录属主和读写权限。另一种情况是公司机器上有统一的环境管理工具，会在启动时重置这些配置，那就得从工具侧放行，光在 IDE 里改没用。

3.4 配完先做一次小包下载验证

代理配好别急着下大包，先挑一个小体积组件试水，比如某个小版本的 Build-Tools 或者一个小的 extras 包。观察下载速度是否明显提升、进度条是否持续推进。小包能通，再回去勾选 Platform 和系统镜像这些大件。

如果小包也卡，回到上一节的连通性探测，确认镜像可达、端口正确、Host 没带多余前缀。三步都对还卡，换一个镜像源再试，不同镜像的同步状态和带宽不一样，这是正常现象，不用怀疑自己配错了。

4. 代理之外的配套配置：Gradle 与依赖下载

4.1 Gradle 分发地址单独配，别指望 SDK 代理全覆盖

SDK Manager 的代理只管 SDK 组件下载，Gradle 自身的分发包和项目依赖走的是另一套网络路径。很多人 SDK 下得飞快，一建项目 Gradle 又卡住，就是没意识到这是两条线。Gradle 分发包地址在项目gradle/wrapper/gradle-wrapper.properties里，可以改成国内镜像提供的分发地址。

# gradle-wrapper.properties 中的分发地址，替换为镜像提供的对应版本 URL distributionUrl=https\://mirrors.example.com/gradle/gradle-8.5-bin.zip

改之前确认镜像上有对应版本的文件，版本号要和项目要求一致，否则 wrapper 校验失败。这一步不是必须，但能省掉建项目时的一次长时间等待。

4.2 依赖仓库换镜像，和 SDK 代理互不影响

项目依赖（Maven 仓库）的镜像配置在settings.gradle或build.gradle的repositories块里，和 SDK Manager 的代理是两回事。常见做法是把google()、mavenCentral()前面加上镜像仓库地址，命中镜像就走镜像，没命中再回源。

// settings.gradle 中调整仓库顺序，镜像在前，官方源兜底 dependencyResolutionManagement { repositories { maven { url 'https://mirrors.example.com/repository/maven-public/' } google() mavenCentral() } }

顺序很重要：镜像放前面才有加速效果，官方源留后面兜底，避免镜像缺包时直接失败。镜像地址按实际可用的填，别照抄示例域名。

4.3 代理和镜像的取舍：什么时候该关掉代理

代理不是一直开着就好。镜像站点维护、同步延迟、或者换到网络条件更好的环境时，继续挂着代理反而慢甚至报错。判断标准很简单：小包下载速度明显低于直连、或者频繁出现连接重置，就先在 SDK Manager 里切回Auto-detect proxy settings或清空手动配置，再试一次直连。代理设置要跟着网络环境走，不是一劳永逸的开关。

5. 常见问题排查：代理配了不生效的几种情况

5.1 现象：填完代理点 OK，下载还是走原速

原因通常是只点了 OK 没点 Apply，或者当前 SDK Manager 窗口是旧进程，配置没重新加载。解决：回到齿轮设置，确认 Host/Port 已保存，关掉 SDK Manager 窗口重新打开，再触发一次下载。还不行就重启 IDE，让配置重新读取。

5.2 现象：报连接被拒或一直转圈

原因多为端口和入口协议不匹配，比如镜像走 https 却填了 80，或者 Host 里多带了http://前缀和路径。解决：Host 只留域名，Port 按协议填 80 或 443，去掉所有前缀和斜杠，保存后重试。

5.3 现象：小包能下，大包下到一半断

原因是镜像带宽波动或连接超时，不是配置错误。解决：换一个镜像源，或者挑网络空闲时段重下；SDK Manager 支持断点续传的情况有限，断在大包上往往要重来，所以大件尽量在确认稳定后再下。

5.4 现象：重启 IDE 后代理设置被重置

原因是配置文件目录权限不足，或被环境管理工具覆盖。解决：检查~/.android/的属主和读写权限，确认没有其他工具在启动时改写配置；公司统一管理的机器需要从管理侧放行。

5.5 现象：SDK 通了但建项目仍卡在依赖下载

原因是 Gradle 分发和依赖仓库走的是独立通道，SDK 代理管不到。解决：按第 4 章单独配 Gradle 分发地址和依赖镜像，两条线分别验证。

6. 装完怎么验证：三步确认代理真的生效

配完代理最怕“看起来配了、其实没走”。我的验证习惯分三步，每步都有明确的观察点，不靠感觉。

第一步，回 SDK Manager 的SDK Tools标签，勾一个几十 MB 的小组件下载，盯进度条。生效的表现是进度持续推进、速度明显高于之前的龟速；不生效的表现是长时间停在Fetching URL或速度没变化。这一步排除“配置没保存”的问题。

第二步，看下载日志里的实际请求地址。SDK Manager 的日志在 IDE 的idea.log或独立日志文件里，搜下载相关的行，确认请求打到了镜像域名而不是官方域名。日志里出现镜像 Host，说明代理链路真的在起作用，而不是碰巧网络变好了。

# 在 IDE 日志目录中筛选与 SDK 下载相关的记录 grep -i "sdk" ~/.cache/Google/AndroidStudio*/log/idea.log | tail -n 20

日志路径随版本和系统不同会有差异，找不到就按 IDE 的Help→Show Log in Explorer/Finder定位。重点看请求域名和响应状态，域名对、状态正常，这一步就算过。

第三步，完整跑一次“新建空项目 → 同步 → 构建”。这一步验证的不只是 SDK 下载，还包括 Gradle 分发、依赖解析、Build-Tools 调用整条链路。同步成功、构建出 APK，说明 SDK 组件齐全、代理没有在半路掉链子。三步都过，这套环境才算真正装完。

从那以后我每次配完 SDK 代理，都强制走一遍这三步，尤其是日志核对那一步——它能把“网络恰好变好”和“代理真的生效”区分开，省掉后面一堆误判。希望帮到你。

本文还有配套的精品资源，点击获取