本文首发于 CSDN转载请注明出处。先说结论Android Studio 装完打不开、或者能打开但一编译就报错原因几乎都是搞混了两个 JDK——一个是 IDE 自带的运行时JetBrains Runtime随安装包一起装在jbr目录里它只负责让 IDE 界面跑起来另一个是项目编译时 Gradle 要用的 JDK它由 Android Gradle 插件AGP决定最低版本不会因为 IDE 能启动就自动满足。认清这两个绝大多数「Gradle build failed」都能自己定位。装之前先确认三件事网上流传的系统要求版本号经常互相矛盾因为 Android Studio 每半年一个大版本、要求一直在动。与其照抄别人的数字不如先确认这三件真正会导致失败的事检查项为什么重要怎么确认系统版本不满足会在解压阶段静默失败没有报错提示以官网下载页标注的系统要求为准磁盘空间安装本身不大但 SDK、模拟器镜像、Gradle 缓存加起来很可观预留 20 GiB 以上比较从容内存低于 8 GiB 时 IDE 与模拟器同时开就会卡8 GiB 起步16 GiB 舒服第一项是最隐蔽的。Linux 上 glibc 版本不够、macOS 系统过旧安装包会在解压环节直接失败而不给出「你的系统太旧」这类明确提示只留下一个莫名其妙的错误。所以下载前先在官网页面对一遍系统和硬件要求比事后排查省时间。下载入口本身也有一个细节官网默认可能跳到一个跟系统不匹配的页面需要手动切到稳定版渠道才能看到对应平台的下载按钮。安装过程中该选什么Windows 上推荐用安装包安装向导里会让勾选组件这三项都要留主程序本身虚拟设备模拟器Android SDK安装路径和 SDK 路径都不要包含中文和空格。这不是洁癖Gradle、NDK、CMake 这些工具链里有不少地方对路径处理得不够健壮中文路径会在构建阶段抛出看不懂的错。还有一个观念要提前建立SDK 路径尽量别放在系统盘或者至少不要放在会被系统清理工具扫描的目录里。SDK 与镜像动辄几十 GiB放在系统盘后续容易触发空间告急。「自带 JDK」这句话到底指什么这是本篇最需要说清的一段。安装包里捆的是一个叫 JetBrains Runtime 的运行时它让 IDE 本身能启动但它不是给项目用的。项目编译走的是 GradleGradle 又受 Android Gradle 插件约束而每个 AGP 版本对 JDK 有最低要求。三者的对应关系大致是这样组件谁决定版本说明IDE 启动安装包自带的运行时不用你操心Gradle 本身Gradle 版本新 Gradle 需要较新的 JDK 才能运行项目编译AGP 版本AGP 7 起要求 JDK 11 以上较新版本已要求 17你写的代码项目里的编译选项决定能用哪些语言特性所以正确做法是打开旧项目时先看项目用的 AGP 版本再决定给 Gradle 配哪个 JDK而不是统一装一个「最新 JDK」了事。装了过新的 JDK 反而会报Unsupported class file major version——这个报错的含义是「你给的 Java 比我能处理的还新」。如果 IDE 里显示项目 SDK 不对去项目结构设置里单独指定 SDK 路径。IDE 的 SDK 配置不跟随系统环境变量这一点和很多人想的不一样。国内网络下怎么让下载顺利安装完成后的第一次启动才是真正考验网络的时候Gradle 发行包、AGP、各种依赖库、SDK 组件都要下载任何一环卡住都会表现为「Gradle sync failed」。处理顺序是这样的软件本身走国内高校或云厂商的镜像站下载比官网快很多且是同一份官方产物。Gradle 发行包和依赖在项目配置里换成国内镜像仓库放在仓库列表靠前的位置。SDK 组件在 SDK 管理器里同样可以配置镜像源。# gradle.properties 里几个明显改善体验的开关 org.gradle.daemontrue # 守护进程避免每次构建都冷启动 org.gradle.paralleltrue # 模块并行构建 org.gradle.cachingtrue # 复用构建缓存 org.gradle.jvmargs-Xmx4096m # 给构建进程更多内存最后一行尤其值得设Gradle 构建进程的内存和 IDE 是分开的机器内存够但构建仍然卡死或者报内存不足往往就是这里没调。这几类报错分别是什么意思Gradle 的报错信息很长但真正有用的只有最后几行。按现象分类更快报错特征根因处理方向Could not resolve all dependencies仓库地址不可达或缺少声明检查仓库列表、代理与镜像配置SSL peer shut down incorrectlyTLS 握手失败更新 JDK或在构建属性里显式指定协议版本Unsupported class file major versionJDK 比构建工具预期的更新换成匹配的 JDK或升级 Gradle编译能过、运行闪退设备 API 等级与代码不匹配核对最低支持版本与真机系统版本「能编译但一运行就崩」这类问题和 JDK 无关多数是 API 等级、权限声明或者资源引用的问题别在 JDK 上反复折腾。排查时先做这两件事在构建面板里点开完整的错误日志看最后一个Caused by再执行一次带--stacktrace的构建拿到更完整的调用链。# 命令行构建拿到比 IDE 里更完整的报错./gradlew assembleDebug--stacktrace装完模拟器跑不动怎么办模拟器依赖 CPU 虚拟化先确认 BIOS 里虚拟化开关是开的Intel VT-x 或 AMD-V。在 Windows 上还有一个常见冲突如果启用了基于虚拟化的安全功能或者其他虚拟化软件模拟器可能无法使用硬件加速表现是启动极慢或者直接黑屏。替代方案有两条用真机调试USB 调试打开即可体验最接近真实环境或者用 ARM 架构的镜像在 Apple 芯片的机器上性能表现明显更好。第一个项目怎么建得干净新建项目时模板会生成一堆示例代码。建议第一个项目用最基础的空模板先确保「能跑起来」这件事成立再逐步加东西。这样一旦出问题变量就只有环境本身排查范围小得多。创建时注意三点包名用反向域名格式但不要用真实拥有的域名做实验避免日后冲突项目路径不要有中文语言选 Kotlin 还是 Java 按你后续要维护的代码来定新项目建议 Kotlin。这套「先分清哪个 JDK 管哪一段」的判断方法比记具体版本号有用得多——版本号半年就变分层关系不会变。这类环境配置的排查记录我会整理成笔记存档多平台分发的时候用墨衍的AI 图文同步一次推完省掉逐处粘贴更新密集时靠发文额度提升不用排队发完再用批量 GEO 检测看内容在 AI 搜索里被引用的状态。墨衍会员权益 有需要可以了解。常见问题QAndroid Studio 到底要不要单独装 JDKIDE 启动不用它自带运行时。但只要你用 Gradle 构建项目就需要一个能被构建工具识别的 JDK具体版本由 AGP 版本决定。Q装了最新 JDK为什么反而报错构建工具还没有支持那么新的 Java 版本。这种情况要么换回匹配的 JDK要么升级 Gradle 与 AGP。QGradle sync 一直转圈怎么办先看是不是卡在下载。换成国内镜像仓库确认代理设置正确必要时手动指定 Gradle 分发版本避免每次都去拉发行包。Q模拟器和真机哪个更值得投入时间学习阶段用真机更省事插上就能跑。需要测试多机型、多分辨率时再回头配置模拟器。Q旧项目打不开提示插件版本过低项目用的 AGP 太旧与当前 IDE 不兼容。要么升级项目的 AGP 与 Gradle 版本要么用旧版 IDE 打开两条路都有代价先评估项目情况。Q构建缓存能清吗可以但要知道代价清了之后第一次构建会明显变慢。只在怀疑缓存损坏、或者报奇怪的资源错误时才清。关于墨衍如果你也在多个平台发技术文章值得看看墨衍。三个最常用的权益——发文额度提升密集更新不再受限、批量 GEO 检测一次扫完全部文章的 AI 引用状态、AI 图文同步一稿多平台分发。点这里了解墨衍会员