常見(jiàn)原因分析

• 網(wǎng)絡(luò)不穩(wěn)定或被墻：國(guó)內(nèi)訪問(wèn) Google 服務(wù)可能會(huì)被防火墻阻斷。
• 代理未正確配置：如果使用公司或校園網(wǎng)代理，需要在 Android Studio 中同步設(shè)置。
• 鏡像源不可用或延遲高：默認(rèn)官方源在國(guó)內(nèi)訪問(wèn)速度很慢。
• 防火墻或殺毒軟件攔截：可能會(huì)阻止 Android Studio 與外部服務(wù)器通信。
• 權(quán)限不足：沒(méi)有管理員/Root 權(quán)限，導(dǎo)致無(wú)法寫入 SDK 目錄。

通用準(zhǔn)備工作

• 確認(rèn)系統(tǒng)時(shí)間和時(shí)區(qū)正確：錯(cuò)誤的時(shí)間會(huì)導(dǎo)致 SSL 證書(shū)校驗(yàn)失敗。
• 關(guān)閉或臨時(shí)禁用防火墻、殺毒軟件：排查是否被本地安全軟件攔截。
• 確保有管理員/Root 權(quán)限：Windows 右鍵“以管理員身份運(yùn)行”，Linux/macOS 使用 sudo。
• 提前下載好 JDK：Android Studio 默認(rèn)捆綁了 OpenJDK，但有時(shí)建議單獨(dú)安裝最新版 JDK 并配置 JAVA_HOME。

Windows 下的解決方案

1. 檢查網(wǎng)絡(luò)與代理

打開(kāi) Android Studio，依次點(diǎn)擊 File > Settings > Appearance & Behavior > System Settings > HTTP Proxy。

根據(jù)你的網(wǎng)絡(luò)環(huán)境，選擇：

• No proxy（無(wú)代理）
• Auto-detect proxy settings（自動(dòng)檢測(cè)）
• Manual proxy configuration（手動(dòng)配置），填寫代理服務(wù)器地址和端口。

點(diǎn)擊 Check connection，測(cè)試 https://dl.google.com 是否可達(dá)。

2. 配置 Android Studio 鏡像源

打開(kāi) File > Settings > Appearance & Behavior > System Settings > Android SDK，點(diǎn)擊 SDK Update Sites 標(biāo)簽。

在列表中選擇 Google、Android Repository，將默認(rèn) URL 替換為國(guó)內(nèi)鏡像，例如：

清華鏡像：

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

阿里云鏡像：

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

點(diǎn)擊 Apply、OK，再次嘗試 SDK Manager。

3. 手動(dòng)下載并導(dǎo)入 SDK

• 訪問(wèn)國(guó)內(nèi)鏡像站，手動(dòng)下載對(duì)應(yīng)版本的 sdk-tools-windows.zip。
• 解壓到自定義目錄，例如 D:\Android\android-sdk。
• 在 Android Studio 中打開(kāi) File > Settings > Appearance & Behavior > System Settings > Android SDK，點(diǎn)擊右上角的 Edit（齒輪圖標(biāo)），選擇 Add Local 指定到你解壓的目錄。
• 手動(dòng)勾選需要的 SDK Platform、SDK Tools，點(diǎn)擊 Apply。

Linux 下的解決方案

1. 環(huán)境變量與代理設(shè)置

# 設(shè)置 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

配置環(huán)境變量：

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（若不存在則創(chuàng)建），添加：

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

然后執(zhí)行 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. 配置代理與鏡像

# 代理設(shè)置（視網(wǎng)絡(luò)環(huán)境而定）
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. 手動(dòng)導(dǎo)入 SDK 到 Android Studio

• 打開(kāi) Android Studio，進(jìn)入 Preferences > Appearance & Behavior > System Settings > Android SDK。
• 點(diǎn)擊右側(cè) Edit（齒輪）選擇 Add Local，定位到 /usr/local/share/android-sdk（或你自定義的路徑）。
• 勾選需要的組件，Apply。

常見(jiàn)問(wèn)題與答疑

• 提示 SSLHandshakeException
  • 檢查系統(tǒng)時(shí)間，確保與網(wǎng)絡(luò)時(shí)間同步；
  • 更換鏡像源；
  • 臨時(shí)關(guān)閉 HTTPS 檢查（不推薦，測(cè)試用）。
• 權(quán)限不足無(wú)法寫入 SDK 目錄
  • Windows：以管理員身份運(yùn)行；
  • macOS/Linux：sudo chown -R $(whoami) /path/to/android-sdk。
• 下載中斷或超時(shí)
  • 多線程下載工具（如 aria2）+ 手動(dòng)導(dǎo)入；
  • 調(diào)整 Android Studio 的下載并發(fā)數(shù)（Settings > Appearance & Behavior > System Settings > HTTP Connection > Maximum connections）。

總結(jié)

通過(guò)網(wǎng)絡(luò)代理、鏡像源替換、手動(dòng)導(dǎo)入、命令行安裝等多種方法，基本覆蓋了 Windows、Linux、macOS 三大平臺(tái)下因網(wǎng)絡(luò)、防火墻、權(quán)限等原因?qū)е聼o(wú)法下載 SDK 的所有常見(jiàn)場(chǎng)景。初學(xué)者可以根據(jù)自身環(huán)境，逐步排查、對(duì)癥下藥。

以上就是Android Studio安裝時(shí)無(wú)法下載SDK的問(wèn)題的解決方案大全(Windows、Linux、Mac)的詳細(xì)內(nèi)容，更多關(guān)于Android Studio無(wú)法下載SDK的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論