如何解决Android Studio安装时无法下载SDK的问题（Windows、Linux、Mac解决方案大全）
前言
对于全栈开发者而言，安装 Android Studio 是迈向 Android 开发的第一步，但在 Windows、Linux、macOS 等不同平台上，经常会遇到“无法下载 SDK”或“SDK Manager 下载超时”等问题。本教程将从环境准备、网络设置、镜像替换、手动导入等多角度给出超详细的解决方案，帮助你一步步排除故障，顺利安装并使用 SDK。
作者✍️ 猫头虎 微信号：Libin9iOak 公众号：猫头虎技术团队 万粉变现经纪人：CSDNWF
作者✍️ 猫头虎微信号：Libin9iOak 公众号：猫头虎技术团队 万粉变现经纪人：CSDNWF
目录
前言
常见原因分析
通用准备工作
Windows 下的解决方案
检查网络与代理配置 Android Studio 镜像源手动下载并导入 SDK Linux 下的解决方案
环境变量与代理设置使用命令行工具安装 SDK更换镜像源 macOS 下的解决方案
Homebrew 安装及更新配置代理与镜像手动导入 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/
阿里云镜像：
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://
export https_proxy=http://
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://
export https_proxy=http://
# 在 ~/.android/repositories.cfg 添加镜像
mkdir -p ~/.android && touch ~/.android/repositories.cfg
cat <
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 开发之旅！
转载自CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/qq_44866828/article/details/148517870