1. 为什么 Android Studio 的安装值得单独写一篇Android Studio 是 Google 官方推出的 Android 应用开发集成开发环境基于 IntelliJ IDEA 社区版深度定制集成了代码编辑、可视化布局、性能分析、模拟器等一整套工具链。Windows 平台是绝大多数国内开发者的主力工作环境但 Android Studio 的安装从来不是“下一步下一步就完事”那么简单——它牵扯到 JDK 版本匹配、SDK 组件下载、Gradle 构建工具链配置、国内网络环境下的镜像加速等一系列连锁问题。我见过太多新手卡在“Gradle sync failed”或者“SDK 下载不动”这两个坎上一卡就是一整天。这篇内容面向的是准备在 Windows 上从零搭建 Android 开发环境的开发者不管你是刚入门的学生、从其他语言转过来的程序员还是需要重新配置一台开发机的老手都能从中找到可以直接照做的步骤。我会把安装过程中每一个关键决策背后的逻辑讲清楚——为什么选这个版本、为什么改这个配置、为什么某个操作顺序不能颠倒。同时我也会把国内网络环境下特有的镜像配置、离线包处理、常见报错排查这些“文档里不会写但实际一定会遇到”的经验一并分享出来。整个流程大致分为四个阶段环境预检与 JDK 准备、Android Studio 主程序安装、SDK 与 Gradle 的配置、以及项目创建后的验证与问题排查。每个阶段都有它的坑我们一个一个来。2. 安装前的环境预检与 JDK 准备2.1 硬件与系统的最低门槛在下载任何东西之前先确认你的机器能不能跑得动。Android Studio 本身是个重型 IDE加上模拟器和 Gradle 构建进程资源消耗相当可观。根据我实际使用的经验官方给的最低配置基本只能保证“能打开”要流畅开发建议至少达到推荐配置。项目最低要求推荐配置说明内存8 GB16 GB 及以上模拟器 IDE Gradle 同时跑8G 会很吃力磁盘空间8 GB 可用20 GB 以上 SSDSDK、模拟器镜像、Gradle 缓存都很占空间屏幕分辨率1280×8001920×1080 及以上布局编辑器需要足够横向空间操作系统Windows 10 64位Windows 10/11 64位32位系统已不被新版本支持磁盘这块我要特别强调一下很多人只留了刚好够安装的空间结果 SDK 组件一下载就爆盘。Android SDK 的 platform-tools、build-tools、多个 API 级别的 platform、系统镜像加起来轻松超过 10 GB。如果你还打算装几个不同 API 级别的模拟器镜像每个镜像大约 1-2 GB空间消耗更快。所以我的建议是至少预留 30 GB 的 SSD 空间机械硬盘虽然也能用但 Gradle 构建和模拟器启动的速度会让你怀疑人生。2.2 JDK 的选择与安装Android Studio 从 Arctic Fox 版本开始已经内置了 JetBrains RuntimeJBR这个运行时基于 OpenJDK 做了定制可以直接用来运行 IDE 本身和 Gradle 构建。也就是说你不再需要像早期版本那样单独安装 Oracle JDK 或 OpenJDK 才能启动 Android Studio。但是这里有个关键区分IDE 自带的 JBR 负责运行 Android Studio 本身而你的项目编译用哪个 JDK是由 Gradle 配置决定的。从 Android Gradle Plugin 8.0 开始编译要求 JDK 17。如果你用的是较新的 Android Studio 版本比如 Hedgehog、Iguana 等创建新项目时默认就会使用内置的 JDK 17一般不需要额外操作。不过实际开发中你可能需要手动指定 JDK 路径。比如你从别人那里接手了一个老项目它的 Gradle 版本和 AGP 版本要求 JDK 11 甚至 JDK 8这时候就需要单独装一个对应版本的 JDK。我的做法是在 Windows 上装一个 JDK 17 作为主力推荐 Eclipse Temurin 或 Microsoft Build of OpenJDK都是免费且维护活跃的发行版然后在 Android Studio 的 Gradle JDK 设置里按项目需要切换。安装 JDK 的步骤本身很简单下载安装包一路下一步即可但有两个细节要注意。第一安装路径尽量不要有空格和中文比如C:\Program Files\Java\jdk-17这种路径虽然能用但某些构建脚本对空格处理不好建议装到C:\Java\jdk-17这样的路径。第二安装完后配置JAVA_HOME环境变量虽然 Android Studio 不强制要求但很多命令行工具比如gradlew会依赖这个变量。# 验证 JDK 是否安装成功打开 PowerShell 或 CMD 执行 java -version # 期望输出类似 # openjdk version 17.0.9 2023-10-17 # OpenJDK Runtime Environment Temurin-17.0.99 (build 17.0.99) # OpenJDK 64-Bit Server VM Temurin-17.0.99 (build 17.0.99, mixed mode, sharing)如果提示java 不是内部或外部命令说明 PATH 没配好需要把%JAVA_HOME%\bin加到系统 PATH 里。2.3 下载渠道与版本选择Android Studio 的官方下载地址是developer.android.com/studio但国内直接访问有时候会比较慢。我的建议是优先从官网下载如果速度实在不行可以找国内镜像站比如一些高校的开源镜像获取安装包。注意核对文件哈希值避免下载到被篡改的安装包。版本选择上Android Studio 分为 Stable稳定版、Beta测试版、Canary金丝雀版三个渠道。生产开发一律选 Stable这个不用犹豫。Beta 和 Canary 虽然能提前体验新功能但 bug 也多不值得为了一点新特性去冒项目构建失败的风险。截至我写这篇内容时比较新的稳定版本包括 Hedgehog2023.1.1、Iguana2023.2.1、Jellyfish2023.3.1等。版本号格式是“年份.主版本.补丁”比如 2023.1.1 表示 2023 年的第 1 个大版本的第 1 个补丁。下载页面会同时提供.exe安装包和.zip免安装包两种形式。.exe适合大多数用户会自动处理快捷方式和卸载入口.zip适合需要便携使用或者没有管理员权限的场景解压后直接运行bin\studio64.exe即可。注意不要从第三方下载站获取安装包那些站点经常捆绑推广软件甚至可能篡改安装程序。官网下载虽然慢一点但安全。3. Android Studio 主程序安装实操3.1 安装向导每一步的取舍双击.exe安装包后向导会依次询问几个配置项这里逐个说明怎么选以及为什么。第一个界面是欢迎页直接 Next。第二个界面让你选择安装组件通常包括 Android Studio 主程序本身和 Android Virtual DeviceAVD即模拟器。两个都勾上模拟器后面调试时一定会用到现在不装后面还得单独补。第三个界面是安装路径选择。默认路径在C:\Program Files\Android\Android Studio如果你的 C 盘空间紧张可以改到其他盘。但注意路径同样不要有中文和空格。我一般习惯装在D:\Android\Android Studio把 IDE 和 SDK 放在同一个盘符下方便管理。第四个界面比较关键问你是否导入之前的设置。如果你是全新安装选“Do not import settings”如果你之前用过 Android Studio 并且做了大量自定义配置比如快捷键、插件、主题可以选择导入旧版本的配置目录。但跨大版本导入有时会带来兼容问题我的经验是跨大版本升级时不要导入重新配置一遍更干净避免一些莫名其妙的 IDE 报错。接下来是许可协议接受即可。然后向导会显示一个摘要页面告诉你将会安装哪些组件、占用多少空间。确认无误后点 Install等待进度条走完。3.2 首次启动的配置向导安装完成后首次启动 Android Studio会进入一个 Setup Wizard这个向导负责帮你完成 SDK 的初始下载和配置。这里有几个决策点需要留意。第一个是安装类型选择通常有 Standard标准和 Custom自定义两个选项。Standard 会自动下载一套默认的 SDK 组件包括最新的 platform、platform-tools、build-tools 和一个模拟器镜像。Custom 则让你手动勾选需要哪些组件、装到哪个目录。对于新手我建议选 Custom原因很简单Standard 默认会把 SDK 装到C:\Users\你的用户名\AppData\Local\Android\Sdk这个路径又深又占 C 盘空间而且 AppData 目录默认隐藏后面找起来很麻烦。选 Custom 可以自己指定一个清晰的路径比如D:\Android\Sdk。第二个是 SDK 组件选择。这里会列出几个必装项Android SDK Platform至少选一个 API 级别建议选当前最新的稳定版和一个稍旧的版本比如 API 34 和 API 33方便测试兼容性。Android SDK Platform-Tools包含adb、fastboot等命令行工具必装。Android SDK Build-Tools编译 APK 需要的工具链选最新版本即可。Android Emulator模拟器本体需要调试时必装。Android SDK Command-line Tools命令行工具某些 Gradle 任务会依赖建议装上。第三个是模拟器镜像的选择。如果你打算用模拟器需要下载至少一个系统镜像。镜像按 CPU 架构分为 x86_64 和 arm64Windows 平台选 x86_64。按 API 级别分建议选一个较新的稳定版。镜像文件比较大1-2 GB下载时间取决于网络状况。3.3 安装目录结构说明安装完成后有必要了解一下 Android Studio 相关文件的目录结构后面排查问题时经常需要定位到这些路径。D:\Android\ ├── Android Studio\ # IDE 主程序安装目录 │ ├── bin\ # 启动脚本 studio64.exe 在这里 │ ├── jbr\ # 内置的 JetBrains Runtime │ ├── plugins\ # 内置插件 │ └── ... └── Sdk\ # SDK 根目录如果你按我建议的自定义路径 ├── platform-tools\ # adb 等工具 ├── build-tools\ # 各版本构建工具 ├── platforms\ # 各 API 级别的 platform ├── system-images\ # 模拟器系统镜像 ├── emulator\ # 模拟器程序 └── cmdline-tools\ # 命令行工具另外Android Studio 的用户配置和缓存默认在C:\Users\你的用户名\AppData\Roaming\Google\AndroidStudio版本号和C:\Users\你的用户名\AppData\Local\Google\AndroidStudio版本号下。Gradle 的缓存默认在C:\Users\你的用户名\.gradle下。这些目录会随着使用不断膨胀特别是 Gradle 缓存用久了可能好几个 GB。定期清理%USERPROFILE%\.gradle\caches可以释放空间但清理后下次构建会重新下载依赖需要权衡。4. SDK 与 Gradle 的配置要点4.1 SDK 路径配置与环境变量SDK 装好之后需要在 Android Studio 里确认路径配置正确。打开File → Settings → Languages Frameworks → Android SDK这里会显示当前使用的 SDK 路径。如果路径不对点右侧的 Edit 修改。同时建议把platform-tools和cmdline-tools\latest\bin加到系统 PATH 环境变量里这样在任意命令行窗口都能直接用adb、sdkmanager等命令。配置方法在系统环境变量 Path 中新增两条记录分别指向这两个目录。# 配置完成后验证 adb version # 期望输出Android Debug Bridge version 1.0.41 之类 sdkmanager --list # 会列出已安装和可用的 SDK 组件4.2 Gradle 国内镜像加速配置Gradle 是 Android 项目的构建工具它需要从远程仓库下载大量依赖库。默认的仓库是 Google 的 Maven 仓库和 Maven Central国内访问速度很不稳定经常出现依赖下载超时导致构建失败。解决办法是配置国内镜像仓库。配置分两个层面。第一个层面是项目级别的仓库配置在项目根目录的settings.gradle新版或build.gradle旧版中修改repositories块。以新版settings.gradle.kts为例// settings.gradle.kts dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { // 阿里云镜像放在最前面优先使用 maven { url uri(https://maven.aliyun.com/repository/google) } maven { url uri(https://maven.aliyun.com/repository/central) } maven { url uri(https://maven.aliyun.com/repository/gradle-plugin) } // 官方仓库作为兜底 google() mavenCentral() } }第二个层面是 Gradle 发行版本体的下载加速。Android Studio 创建项目时会指定一个 Gradle 版本首次构建时需要下载对应的 Gradle 发行包几十到上百 MB。这个下载走的是services.gradle.org国内速度堪忧。解决办法是修改项目中的gradle/wrapper/gradle-wrapper.properties文件把distributionUrl指向国内镜像。# gradle-wrapper.properties # 默认可能是 # distributionUrlhttps\://services.gradle.org/distributions/gradle-8.2-bin.zip # 改为国内镜像以腾讯云为例 distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-8.2-bin.zip注意镜像站不一定有所有版本的 Gradle 发行包如果镜像站没有你需要的版本要么换一个镜像站要么手动下载后放到本地再用file://协议引用。4.3 Gradle JDK 的指定前面提到过Android Studio 内置了 JBR但项目编译用的 JDK 需要单独确认。打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle找到Gradle JDK选项。这里可以选择内置的 JBR、系统安装的 JDK、或者手动指定路径。对于新项目直接用内置的 JBR通常对应 JDK 17就行。对于老项目如果 Gradle 版本较低比如 6.x可能需要切换到 JDK 11 或 JDK 8。切换后记得点 Apply然后重新 sync 项目。4.4 离线包与缓存管理如果你所在的环境网络实在糟糕或者需要给多台机器批量部署可以考虑使用离线包。Gradle 的离线包就是完整的发行 zip下载后放到本地在gradle-wrapper.properties里用file://协议指向它。SDK 组件也可以用sdkmanager的离线模式安装不过操作起来比较繁琐一般只在特殊场景下使用。日常开发中更实用的是利用 Gradle 的构建缓存。同一个依赖下载一次后会缓存在%USERPROFILE%\.gradle\caches\modules-2下后续项目复用。如果你有多个项目共用相同的依赖版本缓存命中率会很高。但要注意不同 Gradle 版本之间的缓存不完全通用升级 Gradle 后可能需要重新下载部分依赖。5. 创建项目验证与常见问题排查5.1 新建项目走通全流程安装配置完成后最直接的验证方式就是创建一个新项目跑起来。打开 Android Studio选择New Project模板选Empty Views Activity传统 View 体系或Empty ActivityCompose 体系两者都可以。填好项目名称、包名、保存路径、语言Java 或 Kotlin、最低 SDK 版本点 Finish。创建后 Android Studio 会自动触发一次 Gradle Sync这个过程会下载所有依赖并生成构建配置。第一次 Sync 通常比较慢视网络情况可能几分钟到十几分钟。Sync 成功后点工具栏的绿色三角按钮Run选择一个模拟器或连接的真机等待编译安装。如果 App 能正常启动并显示 “Hello World”说明整个环境已经通了。5.2 Gradle Sync 失败的典型原因Gradle Sync 失败是新手遇到最多的坎报错信息五花八门但归根结底就那么几类。我整理了一个速查表方便对照排查。报错关键词根本原因解决方向Could not install Gradle distributionGradle 发行包下载失败换国内镜像或手动下载Could not resolve xxx依赖仓库访问不了配置阿里云镜像仓库Unsupported class file major versionJDK 版本与 Gradle/AGP 不匹配切换 Gradle JDK 版本Minimum supported Gradle version is xxxGradle 版本过低升级 gradle-wrapper 中的版本SDK location not foundSDK 路径未配置检查 local.properties 或 SDK 设置Timeout waiting for lockGradle 守护进程锁冲突杀掉 java 进程或重启 IDE其中Could not install Gradle distribution和Could not resolve这两类占了八成以上本质都是网络问题。配好镜像之后基本能解决。5.3 SDK 组件缺失与手动安装有时候 Sync 报错提示缺少某个 SDK 组件比如Failed to find target with hash string android-34。这说明你本地没有安装 API 34 的 platform。解决办法有两种一是打开 SDK Manager 图形界面勾选安装二是用命令行安装。# 用 sdkmanager 安装指定组件 sdkmanager platforms;android-34 build-tools;34.0.0 # 查看已安装组件 sdkmanager --list_installed命令行安装的好处是速度快、可以脚本化适合批量配置环境。但前提是cmdline-tools已经装好并且 PATH 配好了。5.4 模拟器启动失败的排查模拟器启动不了也是高频问题。常见表现有启动后黑屏、提示HAXM is not installed、或者直接闪退。HAXMHardware Accelerated Execution Manager是 Intel 的硬件加速驱动现在新版本 Android Studio 已经改用 Windows Hypervisor PlatformWHPX或 Android Emulator Hypervisor Driver。如果你的机器是 AMD 处理器需要确认 BIOS 里开启了 SVM虚拟化支持。排查步骤先确认 BIOS 虚拟化已开启任务管理器 → 性能 → CPU → 虚拟化显示“已启用”然后在 SDK Manager 的 SDK Tools 标签页里确认Android Emulator Hypervisor Driver已安装。如果还是不行可以尝试在模拟器的 Advanced Settings 里把 Graphics 改为 Software 模式虽然慢但兼容性好。5.5 中文显示与界面汉化Android Studio 官方没有内置中文界面但可以通过安装第三方汉化插件实现。在File → Settings → Plugins里搜索 “Chinese” 相关的语言包插件安装后重启 IDE 即可切换。不过我要提醒一句汉化插件更新往往滞后于 IDE 版本大版本升级后可能出现部分菜单显示异常甚至 IDE 崩溃。如果你英文还过得去建议直接用英文界面遇到问题搜索报错信息时也更容易找到答案因为绝大多数技术资料都是英文的。5.6 项目移植与版本兼容处理从别人那里拿到的项目或者从旧机器迁移过来的项目经常遇到版本不兼容的问题。典型场景是项目用的 AGP 版本很老而你本地装的是新版 Android StudioSync 时提示The project is using an incompatible version of the Android Gradle Plugin。处理思路是先看项目根目录build.gradle里声明的 AGP 版本再看gradle-wrapper.properties里的 Gradle 版本两者有对应关系。AGP 8.x 需要 Gradle 8.xAGP 7.x 需要 Gradle 7.x。如果项目太老可以逐步升级先升 Gradle再升 AGP每次升完 Sync 一次看有没有新的报错。不要一次性全升到最新那样报错会堆在一起很难定位。另外老项目可能还在用buildscript块和allprojects仓库配置新版 Android Studio 推荐用settings.gradle的dependencyResolutionManagement。这个迁移不是必须的老写法目前仍然能用只是会有警告提示。6. 我踩过的坑和几条实用建议装 Android Studio 这件事说起来简单但真正一次顺利走完的人不多。我印象最深的一次是帮同事配环境Gradle Sync 卡在Downloading gradle-8.2-bin.zip整整一个小时没动静换了三个镜像源才搞定。后来我养成了一个习惯拿到新机器先把镜像配好再创建项目能省掉大量等待时间。另一个坑是磁盘空间。我有次 C 盘只剩 5 GB想着“应该够吧”结果 SDK 下到一半空间不足安装程序直接崩了还得手动清理残留文件重来。从那以后我都是把 IDE、SDK、Gradle 缓存全部放到 D 盘C 盘只留系统。还有一点关于版本选择不要盲目追新。我有次用 Canary 版打开一个稳定版项目结果 IDE 自己崩溃了三次换成 Stable 版立刻正常。新版本的新功能对你日常开发未必有用但稳定性问题是实打实的。最后分享一个小技巧如果你需要频繁创建新项目可以把配置好的settings.gradle.kts和gradle-wrapper.properties存成模板每次新建项目后直接覆盖省去重复配镜像的时间。这个操作花不了两分钟但每次新建项目都能省下十几分钟的依赖下载等待。
