新电脑到手装Android Studio这听起来是十分钟的事实际上一折腾可能就是半天。我见过不少人卡在JDK和SDK路径上项目还没建心态先崩了。这篇把从JDK下载、环境变量配置、Android Studio安装到首个项目跑通的完整链路重新捋一遍凡是官网入口、版本选择、常见报错都会拆开讲。先说一个很容易被忽略的事实环境配置里九成的坑不是操作不会而是版本搭配错了。1. 动手之前先想清楚JDK和Android Studio的版本归属关系1.1 Java和Android开发到底是什么关系Android应用的原生开发语言是Java和Kotlin这两门语言最终都要编译成Java字节码再转换成Android虚拟机可执行的DEX格式。整个编译链路里JDKJava Development Kit是不可或缺的底层工具集它负责提供javac编译器和Java运行时环境。生活化类比JDK就像装修时需要的一套冲击钻和水平尺Android Studio则是整个装修工地。工地上有专业工具固然好但很多外接工具和命令行操作仍然需要单独有一套趁手的工具这就是为什么配置JDK环境绕不开。1.2 Android Studio自带JDK为什么还要单独装从Android Studio 3.0开始IDE内置了JetBrains Runtime简称JBR本质就是一个定制化的JDK。也就是说直接下载安装Android Studio不单独装JDK也能正常编译普通项目。很多人看到这里就懵了那JDK还要不要装答案是要但用途不同。单独安装JDK有几个明确场景命令行下用javac直接编译Java文件跑Gradle命令行任务开发Flutter或React Native这类跨平台项目使用某些依赖JAVA_HOME环境变量的第三方工具。更重要的是Android Studio里的Gradle JDK选项可以直接指向你安装的JDK避免IDE内置运行时和外部工具链版本不一致的问题。1.3 版本到底怎么选JDK 8、11还是17网上教程信息严重过时还有人在推荐JDK 8。实际情况是JDK 8已经是十多年前的东西对应老版本的构建工具链新版本Android Studio和Gradle对它支持很差。JDK 11是一个过渡版本可以跑但没有必要专门装。JDK 17是目前最稳的选择新版本Android Studio默认就是基于JDK 17构建的Gradle 8系列也要求JDK 17起步。JDK 21也能用但部分老插件对它的兼容性还不尽如人意没必要冒险。1.4 版本匹配速查表组件推荐版本说明JDKJDK 17LTS当前主流兼容新版AS和GradleAndroid Studio最新稳定版官方下载页默认给的版本Gradle8.x新项目默认需要JDK 17SDK PlatformsAPI 34或35最新稳定版按需补充旧版Build-Tools默认最新一般不用手动指定记住一个核心原则JDK版本尽量往新看但不要追最新Android Studio尽量用官方最新稳定版。新旧搭配反而容易慢性折腾。2. JDK安装与环境变量配置照着做不带脑2.1 JDK官方下载入口JDK官方下载页在https://www.oracle.com/java/technologies/downloads/打开后页面会列出Java SE 17、21等版本选择Java SE 17对应版本再选Windows下的x64 Installermsi格式。如果你希望完全开源也可以选择OpenJDK的发行版比如Temurin 17入口在https://adoptium.net/。两者在功能上没有本质区别个人学习和开发用哪个都行。有两点需要提醒一是下载页面偶尔会弹出版本列表注意别下成JRE。JDK 17之后官方不再单独提供面向普通用户的JRE安装包JDK本身就包含完整的运行时。二是文件名里会带版本号比如jdk-17.0.12_windows-x64_bin.msi认准这个格式。2.2 安装过程默认路径其实最省心双击msi文件一路Next默认安装到C:\Program Files\Java\jdk-17。我建议保持默认路径不要去改成D:\开发工具\JDK这类带中文的目录。为什么反复强调路径问题因为Java生态里大量工具解析路径时对中文和空格的处理很差。默认路径里的Program Files虽然带空格但JDK安装器会处理好这个特殊情况所以没问题。真正会出问题的是你手动改成中文目录后面会有一堆莫名其妙的报错等着你。安装过程中不需要额外操作点完下一步就行。这个环节唯一要注意的是记住你的安装目录后面配置JAVA_HOME需要用到。2.3 三个环境变量的配置逻辑打开Windows设置搜索环境变量或者按WinR输入sysdm.cpl回车进入系统属性里的环境变量设置界面。在系统变量区域依次配置第一个是**JAVA_HOME**新建变量变量值填JDK安装根目录比如C:\Program Files\Java\jdk-17。注意这里不包含bin子目录很多新手容易写成C:\Program Files\Java\jdk-17\bin这样后面就有麻烦了。第二个是**Path**在系统变量里找到Path点击编辑新建一条%JAVA_HOME%\bin。为什么要这样写而不是直接写完整路径因为写完整路径的话以后升级JDK还要回头改Path用%JAVA_HOME%引用的话只改一处JAVA_HOME就够了。第三个是**CLASS_PATH**。这里必须说清楚如果你的JDK是9及以上不要配置CLASS_PATH。网上很多老教程让你配CLASSPATH%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar那是JDK 8及以前的玩法。JDK 9开始模块化之后这两个jar文件被干掉了照着老教程配了等于白配还可能引发类加载的奇怪问题。Windows 11上具体操作路径设置 → 系统 → 关于 → 高级系统设置 → 环境变量。在系统变量区域里操作不要只改用户变量因为有些服务进程读不到用户变量。2.4 命令行验证是否生效配置完成后关键一步必须重新打开一个cmd或PowerShell窗口。旧窗口不会自动刷新环境变量很多人测试半天以为没配好其实就是没开新窗口。输入以下命令逐条验证java -version正常会显示Java 17的版本信息。再输入javac -version如果java正常而javac报不是内部或外部命令说明你的Path里没有正确指向bin目录回去检查环境变量。如果java -version显示的不是17而是什么奇怪的旧版本执行where java这条命令会列出所有被Path扫描到的java可执行文件位置。大概率是别的软件往Path里塞过一条Java路径且排在你的%JAVA_HOME%\bin前面。处理办法就是编辑Path把%JAVA_HOME%\bin上移到列表顶部或者删掉那条指向旧版本的路径。最后再验证JAVA_HOME本身echo %JAVA_HOME%能回显C:\Program Files\Java\jdk-17就说明这一步通关了。3. Android Studio下载安装与首次启动配置3.1 从官方站点拿稳定版安装包Android Studio官方下载页在https://developer.android.com/studioWindows平台选择Download Android Studio按钮会得到一个几百MB的exe安装包。页面上通常还有zip绿色版选项但我从不推荐新手用zip版。绿色版虽然免安装但后续SDK路径、内置JBR的关联全都要手动处理对熟悉的人来说省事对新手来说就是灾难。下载期间多留点耐心文件大网络波动会影响速度。不要在下载过程中频繁暂停续传偶尔会导致文件校验失败到时安装器直接报错。3.2 安装过程中的两个细节安装器启动后保持默认配置但注意组件选择界面。默认会勾选Android SDK、Android Virtual Device、Performance这些核心组件建议全部保留。有个容易被人忽略的步骤是选择安装位置默认在C:\Program Files\Android\Android Studio。如果C盘空间紧张可以改到其他盘但路径仍然必须全英文且不含空格比如D:\Android\Android Studio。安装完成后第一次启动会弹出Import Android Studio Settings from previous version对话框。旧电脑升级或迁移环境的如果有备份可以导入全新安装的选Do not import即可。主题选择、快捷键方案这些后面都能改不用纠结。3.3 首次启动的SDK路径规划这一步很多人没重视后面要吃大亏。首次进入Android Studio会进入Configured向导让你选择Android SDK的安装位置。默认路径是C:\Users\你的用户名\AppData\Local\Android\Sdk。这里有两个隐患第一如果你的Windows用户名是中文比如C:\Users\张三后面大量构建工具会处理不了这个中文路径第二SDK放在系统盘时间越久占用越大C盘压力会越来越明显。所以我建议在一开始就把它改到类似D:\Android\Sdk这样纯英文、无空格的路径。一旦SDK组件下载完成后再改路径就得重新下载非常浪费时间和流量。所以这一步值得停下来想清楚再点下一步。3.4 SDK Manager里到底要装什么进入Android Studio主界面后点击工具栏里的SDK Manager图标或在设置里搜索SDK Manager。这里有几个组件是必须保证装好的Android SDK Platform-Tools包含adb和fastboot后面调试、查看设备都靠它。Android SDK Build-Tools编译期核心工具链。SDK Platforms按需选择一般装最新稳定版API再补一个项目最低支持版本的API即可没必要每个版本都装。在SDK Tools选项卡里Android Studio会标注Recommended项照着勾选就行。模拟器相关组件会在创建虚拟设备时按需下载。这里不需要着急全选装得越多越乱先跑起来再说。3.5 AVD模拟器第一步虚拟设备确保SDK组件就绪后点击Device Manager设备管理器创建模拟器。选择一个虚拟机型比如Pixel系列然后选择系统镜像。推荐选择Google APIs的x86_64镜像这样模拟器性能更接近真机。首次启动模拟器时如果提示硬件加速相关问题最常见的是两种Intel CPU需要在BIOS里确认开启VT虚拟化Windows系统层面可能需要开启Windows虚拟机监控程序平台功能。具体操作控制面板 → 程序 → 启用或关闭Windows功能 → 勾选Hyper-V相关项或Windows虚拟机监控程序平台。AMD CPU则需要在主板BIOS里打开SVM功能。嫌模拟器麻烦的真机用户直接在手机上开启开发者模式再打开USB调试用数据线连电脑就能被识别对前期学习来说比模拟器更省心。4. 新工程跑通后环境配置最常见的报错与排查套路4.1 报错SDK location not found新建或克隆项目后常见到类似SDK location not found或SDK path contains whitespace的提示。原因多半是工程从别处拷贝过来时local.properties文件丢了或者文件里sdk.dir指向的路径并不存在。解决办法很直接在项目根目录新建或修改local.properties文件写入sdk.dirD:\\Android\\Sdk注意反斜杠要转义也就是写成双反斜杠。更省事的方式File → Project Structure → SDK Location在图形界面直接指定SDK路径Android Studio会帮你改写配置文件。我的习惯是把SDK固定在一个统一路径这样不同电脑之间拷贝工程只要改local.properties里一行就能跑。4.2 Gradle构建慢或sync失败新建项目后右下角会长时间显示Gradle: Download...第一次构建尤其慢因为要下载Gradle发行版和大量依赖包。网络稍不稳定就容易失败。正确的应对方式是多给它一点时间不要反复取消重试取消后重新sync只会重新下载。如果确实卡死了可以尝试File → Sync Project with Gradle Files手动触发同步。还有一类sync失败是因为SDK组件没下完整编译时找不到Platform或Build-Tools这时回到SDK Manager把SDK Platforms和Build-Tools对应的版本补上再同步。做开发时留意本地Gradle用户目录默认在%USERPROFILE%\.gradle里面缓存了依赖尽量不要频繁清理。清理一时爽下次构建哭出声。4.3 运行时提示JDK版本不匹配编译或运行时看到类似Unsupported class file major version的错误不用多想就是JDK版本和Gradle版本对不上。较新的Gradle 8要求JDK 17而项目里可能还用的是JDK 8或者Android Studio内部Gradle JDK设置指向了老版本。处理步骤File → Settings → Build, Execution, Deployment → Build Tools → Gradle右侧的Gradle JDK下拉框选择17。如果没有17选项说明JAVA_HOME没有指向JDK 17回头检查环境变量的配置。还有一种情况是项目自带的gradle-wrapper.properties里写死了老版本Gradle和新版Android Studio不兼容这时需要把distributionUrl中的Gradle版本号升级到适配的版本。4.4 控制台中文乱码Windows下编译输出或日志经常出现中文乱码本质是JVM默认用GBK编码读控制台而Android Studio项目默认UTF-8。解决方案Help → Edit Custom VM Options在打开的文件末尾加一行-Dfile.encodingUTF-8保存后重启Android Studio。这个文件是用户级的不会影响系统配置放心改。4.5 模拟器起不来或卡在黑屏模拟器打不开最常见提示是emulator: ERROR: x86 emulation currently requires hardware acceleration!。这说明虚拟化没有开启。对照检查BIOS里VT是否开启Windows功能里Windows虚拟机监控程序平台是否启用。部分机器上HAXM和WHPX同时存在会冲突建议只保留一种加速方案。模拟器启动后黑屏可以先右击设备选择Cold Boot强行冷启动而不是默认的快速启动。冷启动首次会慢一些但能绕过很多状态残留的问题。内存不足时进入AVD编辑界面把模拟器内存调到2048MB左右别贪大一个模拟器吃4GB内存会把整机拖垮。4.6 一条完整的排查链路东试一下西试一下没有章法每次都要绕远路。我建议按下面顺序来java -version确认JDK版本。Android Studio的SDK Manager确认SDK路径和组件完整。手动Sync一下项目观察Gradle构建日志。检查Gradle JDK设置是否符合项目要求。重启Android Studio后仍有问题检查local.properties和gradle-wrapper.properties。模拟器的问题独立来看优先排查硬件虚拟化。按这个顺序走完九成环境问题都能定位到具体环节而不是原地打转。配置环境这件事不是一劳永逸的。JDK升级、Android Studio大版本更新、Gradle迁移每回都会冒出新的排列组合。我个人的做法是把JAVA_HOME、SDK路径、Gradle用户目录这几个关键位置固化下来换新设备时照搬避免在同一个地方反复翻车。最后再分享一个小技巧装好Android Studio之后顺手把platform-tools所在的目录加进系统Path。这样在任意目录下都能直接敲adb devices、gradle --version命令行和IDE两套方式都走得通调试时顺手不少。
