問題背景

Android Studio 在線更新時常因網路限制彈出 Connection failed 錯誤，導致無法下載更新包。網路上流傳的修改 vmoptions 方法多針對 Windows，Mac/Linux 用戶常試無效。本文整理經實測有效的跨平台解法。

核心原理

透過 JVM 參數強制指定更新伺服器 URL 為 Google 官方直連位址（dl.google.com），並偏好 IPv4 協定，繞過區域性 CDN 或防火牆阻擋。

Windows 修正步驟

1. 找到安裝目錄下的 bin\studio64.exe.vmoptions（64 位元）或 studio.exe.vmoptions（32 位元）。
2. 以管理員權限用文字編輯器開啟，在檔案末尾新增三行：

-Djava.net.preferIPv4Stack=true
-Didea.updates.url=https://dl.google.com/android/studio/patches/updates.xml
-Didea.patches.url=https://dl.google.com/android/studio/patches/

3. 存檔，重新啟動 Android Studio，嘗試 Help > Check for Updates。

macOS / Linux 修正步驟（實測有效）

網傳的 export REQUIRED_JVM_ARGS=... 方式在 macOS 常失效，實測直接修改 App 套件內的 idea.vmoptions 才能生效。

1. 在 Finder 找到 Applications / Android Studio.app。
2. 右鍵選擇 「顯示套件內容」。
3. 進入 Contents/bin/idea.vmoptions，以文字編輯器開啟。
4. 在檔案末尾加入與 Windows 相同的三行參數。
5. 存檔，重新啟動 Android Studio，執行更新檢查。

注意： 此為社群驗證的非官方做法，若失效請嘗試官方離線更新包或檢查代理/VPN 設定。修改前建議備份原 vmoptions 檔案。

常見坑點

• 64 位元 Windows 必須改 studio64.exe.vmoptions，改錯檔案不生效。
• macOS 若使用 JetBrains Toolbox 安裝，路徑可能在 ~/Library/Application Support/JetBrains/Toolbox/apps/AndroidStudio/.../idea.vmoptions。
• 參數前綴必須為 -D，不可遺漏。