如何解决Android Studio安装时无法下载SDK的问题（Windows、Linux、Mac解决方案大全）

如何解决Android Studio安装时无法下载SDK的问题（Windows、Linux、Mac解决方案大全）

前言

对于全栈开发者而言，安装 Android Studio 是迈向 Android 开发的第一步，但在 Windows、Linux、macOS 等不同平台上，经常会遇到“无法下载 SDK”或“SDK Manager 下载超时”等问题。本教程将从环境准备、网络设置、镜像替换、手动导入等多角度给出超详细的解决方案，帮助你一步步排除故障，顺利安装并使用 SDK。

常见原因分析

1. 网络不稳定或被墙：国内访问 Google 服务可能会被防火墙阻断。
2. 代理未正确配置：如果使用公司或校园网代理，需要在 Android Studio 中同步设置。
3. 镜像源不可用或延迟高：默认官方源在国内访问速度很慢。
4. 防火墙或杀毒软件拦截：可能会阻止 Android Studio 与外部服务器通信。
5. 权限不足：没有管理员/Root 权限，导致无法写入 SDK 目录。

通用准备工作

• 确认系统时间和时区正确：错误的时间会导致 SSL 证书校验失败。
• 关闭或临时禁用防火墙、杀毒软件：排查是否被本地安全软件拦截。
• 确保有管理员/Root 权限：Windows 右键“以管理员身份运行”，Linux/macOS 使用 sudo。
• 提前下载好 JDK：Android Studio 默认捆绑了 OpenJDK，但有时建议单独安装最新版 JDK 并配置 JAVA_HOME。

Windows 下的解决方案

1. 检查网络与代理

1. 打开 Android Studio，依次点击 File > Settings > Appearance & Behavior > System Settings > HTTP Proxy。
2. 根据你的网络环境，选择：
   • No proxy（无代理）
   • Auto-detect proxy settings（自动检测）
   • Manual proxy configuration（手动配置），填写代理服务器地址和端口。
3. 点击 Check connection，测试 https://dl.google.com 是否可达。

2. 配置 Android Studio 镜像源

打开 File > Settings > Appearance & Behavior > System Settings > Android SDK，点击 SDK Update Sites 标签。

在列表中选择 Google、Android Repository，将默认 URL 替换为国内镜像，例如：

清华镜像：

https://mirrors.tuna.tsinghua.edu.cn/google/android/
https://mirrors.tuna.tsinghua.edu.cn/apache/<component>/

阿里云镜像：

https://developer.aliyun.com/mirror/google

点击 Apply、OK，再次尝试 SDK Manager。

3. 手动下载并导入 SDK

1. 访问国内镜像站，手动下载对应版本的 sdk-tools-windows.zip。
2. 解压到自定义目录，例如 D:\Android\android-sdk。
3. 在 Android Studio 中打开 File > Settings > Appearance & Behavior > System Settings > Android SDK，点击右上角的 Edit（齿轮图标），选择 Add Local 指定到你解压的目录。
4. 手动勾选需要的 SDK Platform、SDK Tools，点击 Apply。

Linux 下的解决方案

1. 环境变量与代理设置

# 设置 JAVA_HOME
echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk' >> ~/.bashrc
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 若需代理
export http_proxy=http://<proxy_host>:<proxy_port>
export https_proxy=http://<proxy_host>:<proxy_port>

2. 使用命令行工具安装 SDK

下载命令行 SDK：

wget https://dl.google.com/android/repository/commandlinetools-linux-XXXX_latest.zip -O cmdline-tools.zip
unzip cmdline-tools.zip -d $HOME/Android/Sdk/cmdline-tools
mv $HOME/Android/Sdk/cmdline-tools/cmdline-tools $HOME/Android/Sdk/cmdline-tools/tools

配置环境变量：

echo 'export ANDROID_SDK_ROOT=$HOME/Android/Sdk' >> ~/.bashrc
echo 'export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/tools/bin' >> ~/.bashrc
source ~/.bashrc

安装 SDK：

sdkmanager --update
sdkmanager "platform-tools" "platforms;android-30"

3. 更换镜像源

编辑 ~/.android/repositories.cfg（若不存在则创建），添加：

### User Sources for Android SDK Manager
count=1
src id:google;https://mirrors.tuna.tsinghua.edu.cn/google/android

然后执行 sdkmanager --update。

macOS 下的解决方案

1. Homebrew 安装及更新

# 安装或更新 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

# 安装 Android SDK 命令行工具
brew install --cask android-sdk

2. 配置代理与镜像

# 代理设置（视网络环境而定）
export http_proxy=http://<proxy_host>:<proxy_port>
export https_proxy=http://<proxy_host>:<proxy_port>

# 在 ~/.android/repositories.cfg 添加镜像
mkdir -p ~/.android && touch ~/.android/repositories.cfg
cat <<EOF > ~/.android/repositories.cfg
count=1
src id:google;https://mirrors.tuna.tsinghua.edu.cn/google/android
EOF

3. 手动导入 SDK 到 Android Studio

1. 打开 Android Studio，进入 Preferences > Appearance & Behavior > System Settings > Android SDK。
2. 点击右侧 Edit（齿轮）选择 Add Local，定位到 /usr/local/share/android-sdk（或你自定义的路径）。
3. 勾选需要的组件，Apply。

常见问题与答疑

1. 提示 SSLHandshakeException
   • 检查系统时间，确保与网络时间同步；
   • 更换镜像源；
   • 临时关闭 HTTPS 检查（不推荐，测试用）。
2. 权限不足无法写入 SDK 目录
   • Windows：以管理员身份运行；
   • macOS/Linux：sudo chown -R $(whoami) /path/to/android-sdk。
3. 下载中断或超时
   • 多线程下载工具（如 aria2）+ 手动导入；
   • 调整 Android Studio 的下载并发数（Settings > Appearance & Behavior > System Settings > HTTP Connection > Maximum connections）。

总结

通过网络代理、镜像源替换、手动导入、命令行安装等多种方法，基本覆盖了 Windows、Linux、macOS 三大平台下因网络、防火墙、权限等原因导致无法下载 SDK 的所有常见场景。初学者可以根据自身环境，逐步排查、对症下药。

希望本教程能够帮助你顺利解决 Android Studio 安装 SDK 的问题，开启愉快的 Android 开发之旅！