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

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

前言

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

作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队万粉变现经纪人：CSDNWF

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

作者✍️
猫头虎微信号：Libin9iOak
公众号：猫头虎技术团队
万粉变现经纪人：CSDNWF

前言
常见原因分析
通用准备工作
Windows 下的解决方案
1. 检查网络与代理
2. 配置 Android Studio 镜像源
3. 手动下载并导入 SDK
Linux 下的解决方案
1. 环境变量与代理设置
2. 使用命令行工具安装 SDK
3. 更换镜像源
macOS 下的解决方案
1. Homebrew 安装及更新
2. 配置代理与镜像
3. 手动导入 SDK
常见问题与答疑
总结

常见原因分析

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

通用准备工作

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

Windows 下的解决方案

作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队万粉变现经纪人：CSDNWF

1. 检查网络与代理

打开 Android Studio，依次点击 File > Settings > Appearance & Behavior > System Settings > HTTP Proxy。
根据你的网络环境，选择：
- No proxy（无代理）
- Auto-detect proxy settings（自动检测）
- Manual proxy configuration（手动配置），填写代理服务器地址和端口。
点击 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

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

Linux 下的解决方案

作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队万粉变现经纪人：CSDNWF

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 下的解决方案

作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队万粉变现经纪人：CSDNWF

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

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

常见问题与答疑

作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队万粉变现经纪人：CSDNWF

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

总结

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

作者✍️
猫头虎微信号：Libin9iOak
公众号：猫头虎技术团队
万粉变现经纪人：CSDNWF

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

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