如何解决Android Studio安装时无法下载SDK的问题（Windows、Linux、Mac解决方案大全）
前言
对于全栈开发者而言，安装 Android Studio 是迈向 Android 开发的第一步，但在 Windows、Linux、macOS 等不同平台上，经常会遇到“无法下载 SDK”或“SDK Manager 下载超时”等问题。本教程将从环境准备、网络设置、镜像替换、手动导入等多角度给出超详细的解决方案，帮助你一步步排除故障，顺利安装并使用 SDK。
作者✍️ 猫头虎 微信号：Libin9iOak 公众号：猫头虎技术团队 万粉变现经纪人：CSDNWF
作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队 万粉变现经纪人：CSDNWF
目录
前言
常见原因分析
通用准备工作
Windows 下的解决方案
Linux 下的解决方案
macOS 下的解决方案
常见问题与答疑
总结
常见原因分析
通用准备工作
- 确认系统时间和时区正确：错误的时间会导致 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
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
常见问题与答疑
作者✍️ 猫头虎微信号：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 开发之旅！
