國內開發者使用 Android Studio 時，常因網絡限制無法直接下載 Gradle、SDK、插件等資源。配置 HTTP 代理（採用國內鏡像站）可完美解決此問題。本文提供從入門到進階的完整配置流程，含鏡像源獲取與驗證技巧。

🌐 為什麼需要配置代理？

• Google 官方倉庫（dl.google.com、maven.google.com、jcenter.bintray.com）在國內訪問極不穩定。
• Gradle Wrapper 下載、SDK Platform/Tools 更新、Maven 依賴解析均會走代理通道。
• 配置後，Android Studio 所有網絡請求（含內建瀏覽器預覽）均走代理，開發體驗質變。

⚙️ 兩種進入設置入口

方式一：歡迎頁面（項目未打開時）

啟動 Android Studio → 歡迎頁面底部「Configure」→ 「Settings」（Windows/Linux）或「Preferences」（macOS）。

方式二：開發界面（項目已打開時）

頂部選單欄 → File → Settings（Windows/Linux） / Android Studio → Preferences（macOS）。

🔧 代理配置詳細步驟

1. 左側導航展開 Appearance & Behavior → System Settings → HTTP Proxy。

2. 選擇 Manual proxy configuration（手動配置）。
3. 在 HTTP Proxy 區塊填入：
   • Host name: 鏡像站域名（如 mirrors.aliyun.com、maven.aliyun.com、gradle.aliyun.com）
   • Port number: 通常為 80、8080、443（視鏡像站而定）
4. 勾選 No proxy for，添加 localhost, 127.0.0.1, *.local, 10.*.*.*, 192.168.*.* 避免本地請求走代理。
5. 點擊 Apply → OK，Android Studio 會提示重啟，重啟後生效。

🔍 國內優質鏡像源獲取與驗證

推薦鏡像站（2024 年仍維護中）

用途	鏡像地址	備註
Gradle 分發包	https://mirrors.cloud.tencent.com/gradle/	騰訊雲 CDN，速度極快
Maven Central / JCenter	https://maven.aliyun.com/repository/public	阿里雲，覆蓋最全
Google Maven	https://maven.aliyun.com/repository/google	AndroidX、Play Services 等
Android SDK	https://mirrors.cloud.tencent.com/android/	SDK Platform/Tools/Build-tools

驗證代理是否生效

1. 打開 File → Settings → Appearance & Behavior → System Settings → HTTP Proxy，點擊 Check connection 輸入 www.google.com 測試。
2. 新建專案，觀察 Gradle Sync 是否順利下載 gradle-x.x-all.zip。
3. 打開 SDK Manager 刷新列表，確認能獲取最新 SDK 版本。

🛠️ 進階：Gradle 層面代理配置（項目級，推薦提交版控）

在專案根目錄 gradle.properties 添加：

systemProp.http.proxyHost=mirrors.aliyun.com
systemProp.http.proxyPort=80
systemProp.https.proxyHost=mirrors.aliyun.com
systemProp.https.proxyPort=443
systemProp.http.nonProxyHosts=localhost|127.0.0.1|*.local|10.*|192.168.*

優先級：Gradle 屬性 > IDE 設置 > 系統代理。團隊協作建議雙重配置，確保 CI/CD 環境一致。

⚠️ 常見坑點與解決

• HTTPS 握手失敗：需在代理設置勾選「HTTPS」並填入相同 Host/Port，或導入鏡像站 CA 證書。
• 代理需認證：在 IDE 代理設置填入 Login/Password，或在 gradle.properties 添加 systemProp.http.proxyUser / systemProp.http.proxyPassword。
• Gradle 守護進程未走代理：重啟 IDE 後執行 ./gradlew --stop 終止舊守護進程。
• macOS 系統代理衝突：關閉系統偏好設定 → 網絡 → 代理，避免雙層代理導致連接重置。

配置完成後，您將體驗到「秒級同步依賴、流暢更新 SDK、無障礙訪問文檔」的絲滑開發體驗，專注於代碼本身，而非與網絡博弈！