如何解決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/<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 開發之旅!