本文提供從硬件選型、JDK/SDK 配置、IDE 安裝、模擬器優化到真機調試的完整 Android 開發環境搭建指南，適合零基礎入門與遷移配置參考。
| 組件 | 最低配置 | 推薦配置 (流暢開發) | 高性能配置 (大型項目) |
|---|---|---|---|
| CPU | 雙核 2.0GHz+ | 6 核心+ (i5-12400 / R5 5600) | 8-12 核心+ (i7-13700K / R9 7900X) |
| 內存 | 8 GB | 16 GB (雙通道 3200MHz+) | 32-64 GB (DDR5 5600+) |
| 存儲 | 256 GB SSD | 512 GB-1 TB NVMe SSD | 1-2 TB NVMe (項目/模擬器/緩存分盤) |
| 顯卡 | 集顯 | 獨顯 4GB+ (GTX 1650 / RTX 3050) | 獨顯 8GB+ (RTX 4060+) |
| 系統 | Win 10/macOS 11/Linux | Win 11 22H2+ / macOS Sonoma / Ubuntu 22.04 LTS | 同上 + WSL2 (Win) |
核心原則：內存 ≥ 16GB 是硬指標 (IDE + Gradle + 模擬器 + 瀏覽器輕鬆佔 12GB+)，NVMe SSD 顯著縮短構建與索引時間。
AndroidDev/
├── jdk/ # JDK 安裝目錄
├── sdk/ # Android SDK 根目錄
│ ├── cmdline-tools/ # 命令行工具
│ ├── platform-tools/ # adb, fastboot
│ ├── build-tools/ # 編譯工具
│ ├── platforms/ # API 平台
│ ├── emulator/ # 模擬器
│ └── sources/ # 源碼
├── ide/ # IDE 安裝目錄
│ ├── android-studio/
│ └── idea/
├── gradle/ # Gradle 緩存/Wrapper (可轉移)
│ └── .gradle/
├── avd/ # AVD 模擬器數據 (可轉移)
│ └── .android/avd/
├── projects/ # 項目工作區
└── tools/ # 其它工具
├── genymotion/
└── virtualbox/
配置環境變量 ANDROID_HOME、ANDROID_SDK_ROOT 指向 sdk 目錄，GRADLE_USER_HOME 指向 gradle 目錄。
JAVA_HOME=C:\AndroidDev\jdk\jdk-17
PATH += %JAVA_HOME%\bin
java -version、javac -version注意：Android Studio / IntelliJ IDEA 內嵌 JBR (JetBrains Runtime) 可獨立運行，但命令行構建、Gradle、SDK 工具仍需系統 JDK。
commandlinetools-win-xxx_latest.zip 解壓到 sdk/cmdline-tools/latest/PATH += %ANDROID_HOME%\cmdline-tools\latest\bin# 接受授權
sdkmanager --licenses
# 安裝核心組件 (根據項目 compileSdk/targetSdk 調整)
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
sdkmanager "sources;android-34" "system-images;android-34;google_apis;x86_64"
sdkmanager "extras;android;m2repository" "extras;google;m2repository"
sdkmanager "emulator" "patcher;v4"
SDK Manager → Tools → Options → 添加鏡像站：
| 鏡像站 | 地址 | 端口 |
|---|---|---|
| 清華大學 | mirrors.tuna.tsinghua.edu.cn | 443 (HTTPS) |
| 中科大 | mirrors.ustc.edu.cn | 443 |
| 阿里雲 | mirrors.aliyun.com | 443 |
或修改 ~/.android/repositories.cfg 手動指定。
| IDE | 優勢 | 適用場景 | 下載方式 |
|---|---|---|---|
| Android Studio (官方) | 功能最全、模擬器集成、Layout Inspector、Profiler、Gradle 深度集成 | 主流 Android 開發、Kotlin 多平台、Compose | 官網 / 国内鏡像 / JetBrains Toolbox |
| IntelliJ IDEA Ultimate | 通用 Java/Kotlin IDE、重構更強、插件生態豐富 | 全棧開發、後端+Android、KMM 共享模塊 | JetBrains 官網 / Toolbox |
| IntelliJ IDEA Community + Android 插件 | 免費、輕量 | 純 Kotlin/Java 庫模塊、學習 | JetBrains 官網 |
| VS Code + Android 插件 | 極簡、啟動快 | Flutter/React Native、輕量編輯 | VS Code Marketplace |
首選推薦：Android Studio (最新穩定版)，內建模擬器、Gradle、SDK Manager、Logcat、Database Inspector 開箱即用。
platform-tools/adb.exe → VirtualBox 指向 VirtualBox 安裝目錄代理/VPN 或晚高峰避開adb devices 顯示 device 即成功# gradle.properties (全局或項目級)
org.gradle.jvmargs=-Xmx3g -XX:MaxMetaspaceSize=512m -XX:+UseG1GC
org.gradle.parallel=true
org.gradle.configureondemand=true
org.gradle.caching=true
android.enableR8=true
android.enableJetifier=true
kotlin.code.style=official
項目級 gradle/wrapper/gradle-wrapper.properties 升級至 Gradle 8.5+ (配合 AGP 8.2+)。
| 問題 | 原因/解決 |
|---|---|
| SDK Manager 加載空白/極慢 | 牆阻擋 Google 服務器 → 配置國內鏡像 / 代理 |
| 模擬器啟動失敗 / 黑屏 | BIOS 開啟 VT-x/AMD-V / Hyper-V 衝突 → 關閉 Hyper-V 或用 AEHD / 更新顯卡驅動 |
| Gradle Sync 失敗 | 依賴下載超時 → 配置阿里/騰訊 Maven 鏡像 / 代理 / 離線模式 |
| ADB 連接斷開 / 未授權 | 更換數據線/端口 / 重新授權 / 重啟 adb server (adb kill-server && adb start-server) |
| IDE 卡頓 / 內存不足 | 修改 studio64.exe.vmoptions / idea64.exe.vmoptions 增加 -Xmx (建議 3-4GB) |
避坑總結：內存 16GB+、NVMe SSD、JDK 17、AGP 8.2+、Gradle 8.5+、國內鏡像、真機驅動預裝。環境搭建一次做對，後續專注業務邏輯而非工具折騰。定期
File → Invalidate Caches清理 IDE 索引異常。
