装 Android Studio 这件事我前前后后折腾过不下几十次给自己装、给学生装、给同事远程排错每次都能碰到新花样。市面上的安装教程多如牛毛但大多只告诉你“点下一步”没告诉你为什么这一步非点不可、哪一步选错了后面会踩坑。这篇文章我不打算写成官方文档的复读机而是从实际安装配置的角度出发把这套环境的底层逻辑讲清楚再给出可照抄的安装步骤、配置方案和排错思路目标是让零基础的新手也能一次跑通从下载安装到创建第一个 HelloWorld 项目。我默认你看这篇文章是想正经学 Android 开发电脑上可能什么都没装也可能之前装过又卸过。不管哪种情况只要按着下面的顺序来基本能避开我之前踩过的绝大多数坑。1. 装之前先把这层“依赖关系”搞清楚1.1 Android Studio 不是普通的软件它是一个完整工具链很多新手最大的误解是把 Android Studio 当成一个“编译器”装完图标双击就能写代码。真实情况是它是一整套工具链的组装件。简单拆解一下一个 Android 工程从源码变成你能在手机上运行的 App至少要经过这三道工序源代码编译Java/Kotlin 代码要先变成字节码这一步由 JDK 负责资源打包与转译布局文件、图片、AndroidManifest 等要经过 Android SDK 构建工具处理这由 SDK、Build Tools 协作完成项目依赖与构建流程编排整个编译、打包、签名、校验由 Gradle 自动调度。所以你需要装的核心东西其实有三层JDKJava 运行环境、Android SDK包括 Platform、Build-Tools、Platform-Tools、Gradle构建工具。Android Studio 本身只是把这三层串起来的图形化外壳。在这个基础上再往深处想一层Android 系统自己用的 Java API 和你本地装的 JDK 并不是一回事。Android 源码里用到的android.jar由 Android SDK 提供里面是精简过的 Java 类库加上系统自身 API。所以不要指望“装了 JDK 就能写 Android”JDK 只是负责把代码编译成 JVM 字节码再由 Android 的 D8/R8 工具转成 Dex 格式。理解这条链路之后遇到各种“类找不到”“SDK 版本不支持”的报错排查思路就会清晰很多。1.2 版本选择与硬件准备别迷信最新版但也不要停留在远古版很多人看到热搜词里出现“androidstudio历史版本下载”就想去找老版本。我的建议是除非你的电脑配置特别低、或者你在跟某个老项目死磕否则直接装官网最新稳定版就好。历史版本唯一合理的用途可能是应付某些老项目里受 Gradle 或 AGPAndroid Gradle Plugin版本限制的情况。但如今 Android Studio 的新版本一般都自带自动迁移机制打开老项目时它会提示你升级 Gradle 或插件版本大多数情况可以无痛处理。与其折腾旧版 IDE 的兼容性问题不如用新版配合项目级配置调整。硬件方面我直接给结论内存至少 8GB但 8GB 只够入门跑模拟器会非常吃力推荐 16GB 起步CPU 建议 4 核以上AMD 和 Intel 都行但虚拟化技术必须在 BIOS 里开启否则模拟器会哭硬盘建议固态Android Studio 本体加 SDK 加 Gradle 缓存装完至少吃掉 10GB用起来之后还会涨C 盘空间紧张的建议装到非系统盘并规划好缓存路径Windows 系统必须是 64 位Android Studio 早就没有 32 位版本了。官网下载地址是developer.android.com/studio国内直接访问有时候会慢但下载安装包一般没问题。部分高校或云镜像站点也有安装包分发实在慢可以考虑。1.3 JDK 这趟浑水到底要不要趟这是新手最容易懵的地方。先说结论从 Android Studio 4.2 开始IDE 已经内置了 JBRJetBrains Runtime本质是一个定制版 JDK 17用于运行 IDE 本身。也就是说装 Android Studio 不需要你手动安装 JDK安装向导里并没有要求你先配 Java 环境的步骤。但为什么网上还有大量“JDK 安装配置”教程因为历史原因。旧版本 Android Studio3.x、4.0、4.1需要单独配置 JDK 8网上很多教程是那个时期写的一直流传到现在。如果你用的是新版完全不需要单独装 JDKJBR 会放在安装目录的jbr文件夹里。有一种情况你可能还是要手动指定 JDK你的电脑同时做别的 Java 开发已经装了更高版本的 JDK结果打开老项目时提示 “Unsupported class file major version” 之类的错误。这通常是 Gradle 版本太老、不认新 JDK。解决办法有两个要么升级项目里的 Gradle wrapper 版本要么到File - Project Structure - SDK Location - JDK location手动指向 Android Studio 自带的jbr目录。我一般倾向于后者因为快且不动项目配置。还有环境变量的问题。很多老教程让你配JAVA_HOME其实新版 Android Studio 不强制要求但如果你后面想用命令行工具如adb那么把 platform-tools 配置到 PATH 是有必要的。这个后面在 SDK 配置部分细说。2. Windows 与 macOS 的安装实操每一步都说清2.1 Windows 安装向导全流程每一步都别乱点拿到安装包.exe后双击运行会出现一个 Welcome 界面。这里注意安装向导默认会勾选 “Android Virtual Device” 组件也就是模拟器相关组件建议保留勾选因为后面跑模拟器要用。接下来是选择安装路径。这一步不要偷懒直接默认安装到C:\Program Files\Android\Android Studio。如果 C 盘空间紧张可以改到其他盘但路径中尽量不要有中文和空格某些第三方构建工具对路径中的空格处理并不友好。我自己的习惯是装到D:\Android\Android Studio干净且好找。安装完成后首次启动它会先询问是否导入旧版本的配置。如果你之前没装过选 “Do not import settings” 即可如果是从旧版本升级可以选导入IDE 会帮你迁移插件和配置这里注意不同大版本比如 3.x 升到 4.x、5.x迁移时偶尔有小毛病需要的话后面可以重置配置。接着会进入欢迎页但先别急着点 “New Project”。此时 IDE 本身装好了但 Android SDK 还没下载需要手动进入配置流程。2.2 macOS 安装需要注意的两个细节macOS 的安装要简单很多下载的.dmg文件打开后把 Android Studio 图标拖进 Applications 文件夹就行。首次运行如果你是从网上下载的包系统可能会提示“无法打开因为无法验证开发者”这时候去系统设置 - 隐私与安全性在底部允许打开即可。另外在 macOS 上SDK 的默认路径是~/Library/Android/sdk如果你介意占用用户目录的空间可以后面在设置里改掉。以及macOS 如果用的是 Apple Silicon 芯片M1/M2/M3不建议强行装 Intel 版本直接用官方 Apple Silicon 版本就好不需要额外装 Rosetta。模拟器性能和稳定性都比 Intel 版本好很多。2.3 首次启动初始化SDK 组件到底勾哪些首次启动会弹出一个 “Android Studio Setup Wizard” 向导选择安装类型时选 “Standard” 它会推荐一整套组件选 “Custom” 可以自己指定 SDK 路径和组件。第一次使用我建议直接 Standard省事它默认帮你装最新稳定版平台。下面是几个关键概念按实际作用拆开讲SDK Platform对应某个 Android API 版本的系统库。App 要运行在哪个 Android 版本上一般就要装哪个平台。建议至少保留一个主流版本比如 API 34Android 14Build-Tools负责把资源文件编译、打包成 APK 的工具集合包括 aapt2、zipalign、apksigner 等。通常跟着项目里buildToolsVersion来Platform-Tools包含adb、fastboot等命令行工具。adb几乎是调试必备建议配到环境变量里Emulator模拟器本体跑虚拟安卓设备用的Android SDK Command-line Tools提供sdkmanager等命令行管理工具进阶使用时会用到。向导选完后就会立刻开始下载。这一步在国内经常卡住可能反复失败、下载速度极慢。这个坑我下一节专门说此刻先记着只要进度条卡得离谱就优先考虑网络方案不要以为是电脑坏了。3. 创建第一个 HelloWorld 项目把整套配置真正跑起来3.1 新建项目该选哪个模板新手别被 Composable 吓到SDK 下载完成后回到 Android Studio 主界面选择 “New Project”。模板列表里有 Empty Views Activity、Empty Activity、Bottom Navigation Activity 等等。新手我建议直接选Empty Views Activity旧版叫 Empty Activity。这个模板会生成一个经典的MainActivity、一个activity_main.xml布局文件最贴近传统 Android 开发方式网上资料也最多。如果你看到的是 “Empty View Activity” 和 “Empty ActivityCompose” 两种要注意区分后者用的是 Jetpack Compose 声明式 UI代码里几乎全是 Kotlin 函数对新手来说理解成本偏高。虽然 Compose 是未来的方向但第一次跑通环境这件事优先级是“先让 App 跑起来”而不是“选未来趋势”。项目名称建议用HelloWorld包名可以保留默认的com.example.helloworld语言默认 Kotlin 就好Minimum SDK 保持默认或者选择 API 24 以上覆盖绝大多数设备。这些选择后期都能改不用太纠结。点击 Finish 后项目就开始创建了。这时候你会看到底部进度条开始跑 Gradle 构建第一次一定会很慢慢到你以为死机了。3.2 第一次构建为什么慢成狗Gradle 的下载逻辑讲清楚Gradle 是 Android 项目背后的构建管家。新建项目时Android Studio 会根据模板里的gradle-wrapper.properties文件自动下载指定版本的 Gradle 发行包并解压到用户目录的~/.gradle/wrapper/dists里。这里的坑在于Gradle 分发包的下载服务器在国外。如果你直接跑经常会出现卡在Downloading gradle-8.x-all.zip的情况半小时一动不动是常态。解决办法有三个按优先级来说手动下载 Gradle 发行包放到 wrapper 目录。先用浏览器或者下载工具从镜像站下载对应版本的 zip比如从腾讯云镜像https://mirrors.cloud.tencent.com/gradle/gradle-8.7-all.zip下载然后把这个 zip 文件放到%USERPROFILE%\.gradle\wrapper\dists\gradle-8.7-all\哈希目录\下面再重新构建时 Gradle 会跳过下载修改distributionUrl指向国内镜像。项目根目录gradle/wrapper/gradle-wrapper.properties里把原来的https\://services.gradle.org/distributions/gradle-8.7-all.zip改成腾讯镜像地址让 Android Studio 直接使用本地 Gradle。在Settings - Build, Execution, Deployment - Build Tools - Gradle里选择 “Use local Gradle distribution”并指定已经下载解压好的 Gradle 路径。这不推荐给新手因为你以后换项目可能就忘了切回来。我个人的方案是“修改 distributionUrl 手动提前下载 zip”一次配置以后所有项目都能吃到镜像加速的红利。Gradle 下载完之后它会继续下载项目依赖。这一步同样卡在 Maven 仓库的访问上默认仓库包括google()和mavenCentral()都需要从国外拉取。解决方案在仓库配置里加入国内阿里云镜像我下一节专门说。3.3 第一次启动 App模拟器和真机怎么选构建完成后工具窗口上方会有一个设备选择下拉框默认可能是 “No Devices”。要跑起 App你需要一台模拟器或者连一台真机。先说你不用花钱的方案在 IDE 右侧打开 “Device Manager”设备管理器点击 “Create device” 选择一台设备型号建议选 Pixel 系列镜像兼容性好然后选择一个系统镜像下载。这里注意系统镜像也很大下载慢同样是常见问题建议选不带 “Google Play” 的版本体积小一些。创建完虚拟设备后点击启动按钮模拟器就会开机。第一次开机会比较慢要有个心理准备。如果你的电脑没有开启虚拟化模拟器会直接报错开机页面一闪就秒退。这个排查在第 4 节讲。真机调试其实更推荐新手使用。手机打开设置 - 关于手机连续点击“版本号”七次打开开发者模式再进系统 - 开发者选项打开 USB 调试。用数据线连接电脑手机弹窗询问是否允许调试时选允许设备就会出现在 Android Studio 里。真机编译安装包会比模拟器快而且不容易遇到模拟器虚拟化的问题对初学者更友好。4. 高频问题排查与提速配置把坑一次填平4.1 卡在 SDK 下载或组件缺失怎么办SDK 下载是新手最容易心态崩的一步。表现是进度条走了十几次都没成功要么一闪而过要么卡在某个百分比不动。先说检查思路。SDK 组件下载逻辑上走的是 Google 的 DL 服务器国内直连速度不稳定失败率高。如果反复失败更推荐的方案是把某些组件放到非高峰期重复尝试或者借助你电脑上已有的网络工具来加速。这里我不展开网络工具的具体配置只强调一旦 SDK Manager 里某个组件的状态反复停留在 “Installed” 和 “Not installed” 之间来回横跳优先怀疑网络问题不要反复删除重装 SDK这样反而会破坏已有的组件。另外有一种报错是 “SDK components directory is missing”通常是因为 SDK 路径被改过或者杀毒软件清理了部分文件。解决办法是在File - Project Structure - SDK Location里重新指定 SDK 路径或者通过 SDK Manager 重新安装缺失组件。关于环境变量如果你以后想在任何终端里直接敲adb、sdkmanager命令把 SDK 下的platform-tools目录Windows 下是platform-tools\加入系统 PATH 即可。Windows 的操作为系统属性 - 环境变量 - Path - 新建填入你的platform-tools路径。macOS / Linux 则是在~/.zshrc或~/.bashrc里加一行export PATH$PATH:$HOME/Library/Android/sdk/platform-tools。注意这里不是必须的纯命令行习惯问题。4.2 构建过慢与仓库镜像方案一条命令都不白敲第一次构建慢到怀疑人生核心原因在于依赖下载。这里我给出一套可复制的配置方案把全局 Maven 仓库替换成阿里云镜像。在项目根目录找到settings.gradle新版模板或build.gradle老版在pluginManagement和dependencyResolutionManagement的repositories块中把下面的镜像地址加进去pluginManagement { repositories { maven { url https://maven.aliyun.com/repository/gradle-plugin } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/gradle-plugin } google() mavenCentral() } }注意 Google 的google()仓库存放着 AndroidX 库、AGP 插件等核心依赖而mavenCentral()存放大数第三方开源库。阿里云镜像对这两个仓库都有独立映射所以这样配置后绝大多数依赖都能从国内镜像拉取速度提升非常明显。做完仓库镜像后如果你之前已经经历过一次“跑半天最后失败”建议清一下本地缓存再试在项目根目录执行gradlew clean或先在File - Invalidate Caches / Restart里清掉 IDE 缓存然后再重新构建。还有一个小技巧全局配置文件~/.gradle/gradle.properties里可以加上下面两行提升构建性能org.gradle.daemontrue org.gradle.paralleltrue org.gradle.jvmargs-Xmx2048m -Dfile.encodingUTF-8daemon让 Gradle 后台常驻parallel开启并行构建jvmargs调高 Gradle 可用内存。如果你电脑内存只有 8GB-Xmx2048m已经够了不用贪多。4.3 AVD 模拟器启动失败的常见原因模拟器启动失败几乎可以列一个“为什么每次都这样”的清单虚拟化未开启。启动模拟器时提示 “The emulator process for AVD xxx has terminated” 或者升级到 Android Studio 5.x 后提示 hypervisor 相关问题八成是 BIOS 里的 Intel VT-x / AMD-V 没开或者 Windows 的 Hyper-V 功能与 HAXM/WHPX 冲突。解决办法重启进 BIOS 开启虚拟化保底方案就是在 Windows 功能里打开 “Windows Hypervisor Platform”。开启后大概率模拟器能正常起来镜像架构与宿主不匹配。如果你的 CPU 是 Intel 但镜像列表里只有 ARM 架构别硬选。ARM 镜像在 x86 机器上跑会慢到像幻灯片。一个排查套路去 SDK Manager 的 SDK Platforms 页签里确认系统镜像是否包含 x86_64 版本一般选 “Google APIs Intel x86_64” 或 “Google APIs ARM64-v8a” 要对应你的 CPU 架构端口冲突。ADB 默认使用 5037 端口模拟器使用 5554/5555 等端口。如果你电脑上装了其他安卓模拟器尤其是某些游戏模拟器可能把端口占满了。解决办法是关掉其他模拟器或者用adb kill-server后重新adb start-server磁盘空间不足。AVD 镜像和用户数据加起来不小系统盘如果满了模拟器启动到一半会闪退。这种情况日志里会写 “Not enough space to complete the AVD” 之类的内容。根因排查建议先看日志$HOME\.android\avd\下有每个虚拟设备对应的目录里面有*.log文件IDE 也提供Help - Show Log in ExplorerWindows或Help - Show Log in FindermacOS日志能给出比弹窗多十倍的细节。4.4 环境变量、JBR 版本冲突与其它老项目兼容问题新版 Android Studio 默认自带 JBR大多数时候你不需要关心 JDK。但总有例外比如你用 Kotlin 2.x 插件配老项目或者项目里用到了旧版 Gradle这时往往会出现版本校验失败报错形如Unsupported class file major version 65这是 Java 21 访问老 class 文件的典型提示。最快捷的解决方式是到Project Structure - SDK Location里把 JDK 指向 Android Studio 自带jbr目录它会随着 IDE 大版本升级而更新版本一般不会太超前报错No Java runtime present, requesting install多见于命令行直接执行gradlew时。解决办法是在系统环境变量里新建JAVA_HOME指向 Android Studio 的jbr路径再把%JAVA_HOME%\bin加到 PATH。注意这台机器还是不需要单独装 JDK用 IDE 自带的就行老项目打不开提示需要旧版 AGP。我建议你先点 “Try Again” 或升级 AGP而不是急着装老版本 Android Studio。因为 AGP 是从上向下兼容的调高版本通常只是多下载点依赖比维护两套 IDE 划算。另外关于“androidstudio设定crlf换行”这类热词这是 Git 换行符处理的问题。Windows 下 IDE 默认可能保存为 CRLF而项目仓库要求 LF容易在 Git 里出现“整文件变更”的噪音。建议在.gitattributes里统一设置或者在 Android Studio 的Settings - Editor - Code Style - Line separator里选择Unix and macOS (\n)让新建文件默认用 LF。这个问题不影响项目编译但影响团队协作体验值得顺手配好。5. 安装完成之后这些后续配置建议尽早做5.1 调整 IDE 内存设置别等卡了再后悔Android Studio 默认给 IDE 分配的内存不算多新手打开一个小项目感觉不出来一旦开了模拟器、再挂着好几个悬浮窗口卡顿感立刻袭来。在Help - Change Memory Settings里可以看到当前堆内存上限我个人建议 8GB 内存的机器设为 2GB16GB 的机器设为 3GB 或 4GB不要盲目拉高到 8GB否则系统本身内存不够反而会整个电脑卡死。修改后需要重启 IDE 生效。如果修改后仍然卡可以顺手关掉一些不必要的插件在Settings - Plugins里按需禁用。5.2 给 C 盘减负把缓存目录移走Android Studio 的缓存散落在几个目录日积月累非常占空间。Windows 下主要是C:\Users\用户名\.gradleGradle 缓存包括依赖和 wrapper 发行包C:\Users\用户名\.android模拟器 AVD 数据、adb key 等C:\Users\用户名\AppData\Local\Android\SdkSDK 本体C:\Users\用户名\AppData\Local\Google\AndroidStudio版本号IDE 日志、索引缓存。如果 C 盘是小容量固态建议把.gradle和Android\Sdk迁移到其他盘。.gradle迁移方式是设置环境变量GRADLE_USER_HOME指向新路径比如D:\Android\.gradle然后把原来的目录整体复制过去重新打开 Android Studio 即可。SDK 迁移方式更简单直接把文件夹复制到新路径然后在Project Structure - SDK Location里改一下指向。macOS 同理~/.gradle和~/Library/Android/sdk都可以通过符号链接或环境变量搬到其他卷。5.3 从 HelloWorld 到下一个项目路径别跑偏安装配置跑通不是终点只是起点。跑完 HelloWorld 之后我建议你按这个顺序继续深入试着改改界面布局熟悉XML里LinearLayout、ConstraintLayout的基本写法给 HelloWorld 加一个 Button点击之后通过Toast弹一段文字。这会迫你去了解 Activity、findViewById或ViewBinding、事件监听这些基础概念试试在真机上跑通一遍adb install、adb logcat的流程命令行里看日志会让你的排错能力上一个台阶再往后才是 Jetpack Compose、网络请求、数据库这些进阶内容。我个人经历里的一个体会是很多人卡在环境配置这一关其实不是笨而是教程里大量本该讲清的概念被一句话带过了。比如 “SDK 和 JDK 到底什么关系” “Gradle 为什么要联网” 这些底层逻辑一旦理解透了装环境就只是按部就班的事情。希望这篇内容能帮你少走一些我当年走过的弯路一次把环境配好。最后再分享一个小技巧把gradle-wrapper.properties和settings.gradle的镜像配置提交到 Git换电脑、换同事协作时能少受很多折腾。
装 Android Studio 这件事我前前后后折腾过不下几十次给自己装、给学生装、给同事远程排错每次都能碰到新花样。市面上的安装教程多如牛毛但大多只告诉你“点下一步”没告诉你为什么这一步非点不可、哪一步选错了后面会踩坑。这篇文章我不打算写成官方文档的复读机而是从实际安装配置的角度出发把这套环境的底层逻辑讲清楚再给出可照抄的安装步骤、配置方案和排错思路目标是让零基础的新手也能一次跑通从下载安装到创建第一个 HelloWorld 项目。我默认你看这篇文章是想正经学 Android 开发电脑上可能什么都没装也可能之前装过又卸过。不管哪种情况只要按着下面的顺序来基本能避开我之前踩过的绝大多数坑。1. 装之前先把这层“依赖关系”搞清楚1.1 Android Studio 不是普通的软件它是一个完整工具链很多新手最大的误解是把 Android Studio 当成一个“编译器”装完图标双击就能写代码。真实情况是它是一整套工具链的组装件。简单拆解一下一个 Android 工程从源码变成你能在手机上运行的 App至少要经过这三道工序源代码编译Java/Kotlin 代码要先变成字节码这一步由 JDK 负责资源打包与转译布局文件、图片、AndroidManifest 等要经过 Android SDK 构建工具处理这由 SDK、Build Tools 协作完成项目依赖与构建流程编排整个编译、打包、签名、校验由 Gradle 自动调度。所以你需要装的核心东西其实有三层JDKJava 运行环境、Android SDK包括 Platform、Build-Tools、Platform-Tools、Gradle构建工具。Android Studio 本身只是把这三层串起来的图形化外壳。在这个基础上再往深处想一层Android 系统自己用的 Java API 和你本地装的 JDK 并不是一回事。Android 源码里用到的android.jar由 Android SDK 提供里面是精简过的 Java 类库加上系统自身 API。所以不要指望“装了 JDK 就能写 Android”JDK 只是负责把代码编译成 JVM 字节码再由 Android 的 D8/R8 工具转成 Dex 格式。理解这条链路之后遇到各种“类找不到”“SDK 版本不支持”的报错排查思路就会清晰很多。1.2 版本选择与硬件准备别迷信最新版但也不要停留在远古版很多人看到热搜词里出现“androidstudio历史版本下载”就想去找老版本。我的建议是除非你的电脑配置特别低、或者你在跟某个老项目死磕否则直接装官网最新稳定版就好。历史版本唯一合理的用途可能是应付某些老项目里受 Gradle 或 AGPAndroid Gradle Plugin版本限制的情况。但如今 Android Studio 的新版本一般都自带自动迁移机制打开老项目时它会提示你升级 Gradle 或插件版本大多数情况可以无痛处理。与其折腾旧版 IDE 的兼容性问题不如用新版配合项目级配置调整。硬件方面我直接给结论内存至少 8GB但 8GB 只够入门跑模拟器会非常吃力推荐 16GB 起步CPU 建议 4 核以上AMD 和 Intel 都行但虚拟化技术必须在 BIOS 里开启否则模拟器会哭硬盘建议固态Android Studio 本体加 SDK 加 Gradle 缓存装完至少吃掉 10GB用起来之后还会涨C 盘空间紧张的建议装到非系统盘并规划好缓存路径Windows 系统必须是 64 位Android Studio 早就没有 32 位版本了。官网下载地址是developer.android.com/studio国内直接访问有时候会慢但下载安装包一般没问题。部分高校或云镜像站点也有安装包分发实在慢可以考虑。1.3 JDK 这趟浑水到底要不要趟这是新手最容易懵的地方。先说结论从 Android Studio 4.2 开始IDE 已经内置了 JBRJetBrains Runtime本质是一个定制版 JDK 17用于运行 IDE 本身。也就是说装 Android Studio 不需要你手动安装 JDK安装向导里并没有要求你先配 Java 环境的步骤。但为什么网上还有大量“JDK 安装配置”教程因为历史原因。旧版本 Android Studio3.x、4.0、4.1需要单独配置 JDK 8网上很多教程是那个时期写的一直流传到现在。如果你用的是新版完全不需要单独装 JDKJBR 会放在安装目录的jbr文件夹里。有一种情况你可能还是要手动指定 JDK你的电脑同时做别的 Java 开发已经装了更高版本的 JDK结果打开老项目时提示 “Unsupported class file major version” 之类的错误。这通常是 Gradle 版本太老、不认新 JDK。解决办法有两个要么升级项目里的 Gradle wrapper 版本要么到File - Project Structure - SDK Location - JDK location手动指向 Android Studio 自带的jbr目录。我一般倾向于后者因为快且不动项目配置。还有环境变量的问题。很多老教程让你配JAVA_HOME其实新版 Android Studio 不强制要求但如果你后面想用命令行工具如adb那么把 platform-tools 配置到 PATH 是有必要的。这个后面在 SDK 配置部分细说。2. Windows 与 macOS 的安装实操每一步都说清2.1 Windows 安装向导全流程每一步都别乱点拿到安装包.exe后双击运行会出现一个 Welcome 界面。这里注意安装向导默认会勾选 “Android Virtual Device” 组件也就是模拟器相关组件建议保留勾选因为后面跑模拟器要用。接下来是选择安装路径。这一步不要偷懒直接默认安装到C:\Program Files\Android\Android Studio。如果 C 盘空间紧张可以改到其他盘但路径中尽量不要有中文和空格某些第三方构建工具对路径中的空格处理并不友好。我自己的习惯是装到D:\Android\Android Studio干净且好找。安装完成后首次启动它会先询问是否导入旧版本的配置。如果你之前没装过选 “Do not import settings” 即可如果是从旧版本升级可以选导入IDE 会帮你迁移插件和配置这里注意不同大版本比如 3.x 升到 4.x、5.x迁移时偶尔有小毛病需要的话后面可以重置配置。接着会进入欢迎页但先别急着点 “New Project”。此时 IDE 本身装好了但 Android SDK 还没下载需要手动进入配置流程。2.2 macOS 安装需要注意的两个细节macOS 的安装要简单很多下载的.dmg文件打开后把 Android Studio 图标拖进 Applications 文件夹就行。首次运行如果你是从网上下载的包系统可能会提示“无法打开因为无法验证开发者”这时候去系统设置 - 隐私与安全性在底部允许打开即可。另外在 macOS 上SDK 的默认路径是~/Library/Android/sdk如果你介意占用用户目录的空间可以后面在设置里改掉。以及macOS 如果用的是 Apple Silicon 芯片M1/M2/M3不建议强行装 Intel 版本直接用官方 Apple Silicon 版本就好不需要额外装 Rosetta。模拟器性能和稳定性都比 Intel 版本好很多。2.3 首次启动初始化SDK 组件到底勾哪些首次启动会弹出一个 “Android Studio Setup Wizard” 向导选择安装类型时选 “Standard” 它会推荐一整套组件选 “Custom” 可以自己指定 SDK 路径和组件。第一次使用我建议直接 Standard省事它默认帮你装最新稳定版平台。下面是几个关键概念按实际作用拆开讲SDK Platform对应某个 Android API 版本的系统库。App 要运行在哪个 Android 版本上一般就要装哪个平台。建议至少保留一个主流版本比如 API 34Android 14Build-Tools负责把资源文件编译、打包成 APK 的工具集合包括 aapt2、zipalign、apksigner 等。通常跟着项目里buildToolsVersion来Platform-Tools包含adb、fastboot等命令行工具。adb几乎是调试必备建议配到环境变量里Emulator模拟器本体跑虚拟安卓设备用的Android SDK Command-line Tools提供sdkmanager等命令行管理工具进阶使用时会用到。向导选完后就会立刻开始下载。这一步在国内经常卡住可能反复失败、下载速度极慢。这个坑我下一节专门说此刻先记着只要进度条卡得离谱就优先考虑网络方案不要以为是电脑坏了。3. 创建第一个 HelloWorld 项目把整套配置真正跑起来3.1 新建项目该选哪个模板新手别被 Composable 吓到SDK 下载完成后回到 Android Studio 主界面选择 “New Project”。模板列表里有 Empty Views Activity、Empty Activity、Bottom Navigation Activity 等等。新手我建议直接选Empty Views Activity旧版叫 Empty Activity。这个模板会生成一个经典的MainActivity、一个activity_main.xml布局文件最贴近传统 Android 开发方式网上资料也最多。如果你看到的是 “Empty View Activity” 和 “Empty ActivityCompose” 两种要注意区分后者用的是 Jetpack Compose 声明式 UI代码里几乎全是 Kotlin 函数对新手来说理解成本偏高。虽然 Compose 是未来的方向但第一次跑通环境这件事优先级是“先让 App 跑起来”而不是“选未来趋势”。项目名称建议用HelloWorld包名可以保留默认的com.example.helloworld语言默认 Kotlin 就好Minimum SDK 保持默认或者选择 API 24 以上覆盖绝大多数设备。这些选择后期都能改不用太纠结。点击 Finish 后项目就开始创建了。这时候你会看到底部进度条开始跑 Gradle 构建第一次一定会很慢慢到你以为死机了。3.2 第一次构建为什么慢成狗Gradle 的下载逻辑讲清楚Gradle 是 Android 项目背后的构建管家。新建项目时Android Studio 会根据模板里的gradle-wrapper.properties文件自动下载指定版本的 Gradle 发行包并解压到用户目录的~/.gradle/wrapper/dists里。这里的坑在于Gradle 分发包的下载服务器在国外。如果你直接跑经常会出现卡在Downloading gradle-8.x-all.zip的情况半小时一动不动是常态。解决办法有三个按优先级来说手动下载 Gradle 发行包放到 wrapper 目录。先用浏览器或者下载工具从镜像站下载对应版本的 zip比如从腾讯云镜像https://mirrors.cloud.tencent.com/gradle/gradle-8.7-all.zip下载然后把这个 zip 文件放到%USERPROFILE%\.gradle\wrapper\dists\gradle-8.7-all\哈希目录\下面再重新构建时 Gradle 会跳过下载修改distributionUrl指向国内镜像。项目根目录gradle/wrapper/gradle-wrapper.properties里把原来的https\://services.gradle.org/distributions/gradle-8.7-all.zip改成腾讯镜像地址让 Android Studio 直接使用本地 Gradle。在Settings - Build, Execution, Deployment - Build Tools - Gradle里选择 “Use local Gradle distribution”并指定已经下载解压好的 Gradle 路径。这不推荐给新手因为你以后换项目可能就忘了切回来。我个人的方案是“修改 distributionUrl 手动提前下载 zip”一次配置以后所有项目都能吃到镜像加速的红利。Gradle 下载完之后它会继续下载项目依赖。这一步同样卡在 Maven 仓库的访问上默认仓库包括google()和mavenCentral()都需要从国外拉取。解决方案在仓库配置里加入国内阿里云镜像我下一节专门说。3.3 第一次启动 App模拟器和真机怎么选构建完成后工具窗口上方会有一个设备选择下拉框默认可能是 “No Devices”。要跑起 App你需要一台模拟器或者连一台真机。先说你不用花钱的方案在 IDE 右侧打开 “Device Manager”设备管理器点击 “Create device” 选择一台设备型号建议选 Pixel 系列镜像兼容性好然后选择一个系统镜像下载。这里注意系统镜像也很大下载慢同样是常见问题建议选不带 “Google Play” 的版本体积小一些。创建完虚拟设备后点击启动按钮模拟器就会开机。第一次开机会比较慢要有个心理准备。如果你的电脑没有开启虚拟化模拟器会直接报错开机页面一闪就秒退。这个排查在第 4 节讲。真机调试其实更推荐新手使用。手机打开设置 - 关于手机连续点击“版本号”七次打开开发者模式再进系统 - 开发者选项打开 USB 调试。用数据线连接电脑手机弹窗询问是否允许调试时选允许设备就会出现在 Android Studio 里。真机编译安装包会比模拟器快而且不容易遇到模拟器虚拟化的问题对初学者更友好。4. 高频问题排查与提速配置把坑一次填平4.1 卡在 SDK 下载或组件缺失怎么办SDK 下载是新手最容易心态崩的一步。表现是进度条走了十几次都没成功要么一闪而过要么卡在某个百分比不动。先说检查思路。SDK 组件下载逻辑上走的是 Google 的 DL 服务器国内直连速度不稳定失败率高。如果反复失败更推荐的方案是把某些组件放到非高峰期重复尝试或者借助你电脑上已有的网络工具来加速。这里我不展开网络工具的具体配置只强调一旦 SDK Manager 里某个组件的状态反复停留在 “Installed” 和 “Not installed” 之间来回横跳优先怀疑网络问题不要反复删除重装 SDK这样反而会破坏已有的组件。另外有一种报错是 “SDK components directory is missing”通常是因为 SDK 路径被改过或者杀毒软件清理了部分文件。解决办法是在File - Project Structure - SDK Location里重新指定 SDK 路径或者通过 SDK Manager 重新安装缺失组件。关于环境变量如果你以后想在任何终端里直接敲adb、sdkmanager命令把 SDK 下的platform-tools目录Windows 下是platform-tools\加入系统 PATH 即可。Windows 的操作为系统属性 - 环境变量 - Path - 新建填入你的platform-tools路径。macOS / Linux 则是在~/.zshrc或~/.bashrc里加一行export PATH$PATH:$HOME/Library/Android/sdk/platform-tools。注意这里不是必须的纯命令行习惯问题。4.2 构建过慢与仓库镜像方案一条命令都不白敲第一次构建慢到怀疑人生核心原因在于依赖下载。这里我给出一套可复制的配置方案把全局 Maven 仓库替换成阿里云镜像。在项目根目录找到settings.gradle新版模板或build.gradle老版在pluginManagement和dependencyResolutionManagement的repositories块中把下面的镜像地址加进去pluginManagement { repositories { maven { url https://maven.aliyun.com/repository/gradle-plugin } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/gradle-plugin } google() mavenCentral() } }注意 Google 的google()仓库存放着 AndroidX 库、AGP 插件等核心依赖而mavenCentral()存放大数第三方开源库。阿里云镜像对这两个仓库都有独立映射所以这样配置后绝大多数依赖都能从国内镜像拉取速度提升非常明显。做完仓库镜像后如果你之前已经经历过一次“跑半天最后失败”建议清一下本地缓存再试在项目根目录执行gradlew clean或先在File - Invalidate Caches / Restart里清掉 IDE 缓存然后再重新构建。还有一个小技巧全局配置文件~/.gradle/gradle.properties里可以加上下面两行提升构建性能org.gradle.daemontrue org.gradle.paralleltrue org.gradle.jvmargs-Xmx2048m -Dfile.encodingUTF-8daemon让 Gradle 后台常驻parallel开启并行构建jvmargs调高 Gradle 可用内存。如果你电脑内存只有 8GB-Xmx2048m已经够了不用贪多。4.3 AVD 模拟器启动失败的常见原因模拟器启动失败几乎可以列一个“为什么每次都这样”的清单虚拟化未开启。启动模拟器时提示 “The emulator process for AVD xxx has terminated” 或者升级到 Android Studio 5.x 后提示 hypervisor 相关问题八成是 BIOS 里的 Intel VT-x / AMD-V 没开或者 Windows 的 Hyper-V 功能与 HAXM/WHPX 冲突。解决办法重启进 BIOS 开启虚拟化保底方案就是在 Windows 功能里打开 “Windows Hypervisor Platform”。开启后大概率模拟器能正常起来镜像架构与宿主不匹配。如果你的 CPU 是 Intel 但镜像列表里只有 ARM 架构别硬选。ARM 镜像在 x86 机器上跑会慢到像幻灯片。一个排查套路去 SDK Manager 的 SDK Platforms 页签里确认系统镜像是否包含 x86_64 版本一般选 “Google APIs Intel x86_64” 或 “Google APIs ARM64-v8a” 要对应你的 CPU 架构端口冲突。ADB 默认使用 5037 端口模拟器使用 5554/5555 等端口。如果你电脑上装了其他安卓模拟器尤其是某些游戏模拟器可能把端口占满了。解决办法是关掉其他模拟器或者用adb kill-server后重新adb start-server磁盘空间不足。AVD 镜像和用户数据加起来不小系统盘如果满了模拟器启动到一半会闪退。这种情况日志里会写 “Not enough space to complete the AVD” 之类的内容。根因排查建议先看日志$HOME\.android\avd\下有每个虚拟设备对应的目录里面有*.log文件IDE 也提供Help - Show Log in ExplorerWindows或Help - Show Log in FindermacOS日志能给出比弹窗多十倍的细节。4.4 环境变量、JBR 版本冲突与其它老项目兼容问题新版 Android Studio 默认自带 JBR大多数时候你不需要关心 JDK。但总有例外比如你用 Kotlin 2.x 插件配老项目或者项目里用到了旧版 Gradle这时往往会出现版本校验失败报错形如Unsupported class file major version 65这是 Java 21 访问老 class 文件的典型提示。最快捷的解决方式是到Project Structure - SDK Location里把 JDK 指向 Android Studio 自带jbr目录它会随着 IDE 大版本升级而更新版本一般不会太超前报错No Java runtime present, requesting install多见于命令行直接执行gradlew时。解决办法是在系统环境变量里新建JAVA_HOME指向 Android Studio 的jbr路径再把%JAVA_HOME%\bin加到 PATH。注意这台机器还是不需要单独装 JDK用 IDE 自带的就行老项目打不开提示需要旧版 AGP。我建议你先点 “Try Again” 或升级 AGP而不是急着装老版本 Android Studio。因为 AGP 是从上向下兼容的调高版本通常只是多下载点依赖比维护两套 IDE 划算。另外关于“androidstudio设定crlf换行”这类热词这是 Git 换行符处理的问题。Windows 下 IDE 默认可能保存为 CRLF而项目仓库要求 LF容易在 Git 里出现“整文件变更”的噪音。建议在.gitattributes里统一设置或者在 Android Studio 的Settings - Editor - Code Style - Line separator里选择Unix and macOS (\n)让新建文件默认用 LF。这个问题不影响项目编译但影响团队协作体验值得顺手配好。5. 安装完成之后这些后续配置建议尽早做5.1 调整 IDE 内存设置别等卡了再后悔Android Studio 默认给 IDE 分配的内存不算多新手打开一个小项目感觉不出来一旦开了模拟器、再挂着好几个悬浮窗口卡顿感立刻袭来。在Help - Change Memory Settings里可以看到当前堆内存上限我个人建议 8GB 内存的机器设为 2GB16GB 的机器设为 3GB 或 4GB不要盲目拉高到 8GB否则系统本身内存不够反而会整个电脑卡死。修改后需要重启 IDE 生效。如果修改后仍然卡可以顺手关掉一些不必要的插件在Settings - Plugins里按需禁用。5.2 给 C 盘减负把缓存目录移走Android Studio 的缓存散落在几个目录日积月累非常占空间。Windows 下主要是C:\Users\用户名\.gradleGradle 缓存包括依赖和 wrapper 发行包C:\Users\用户名\.android模拟器 AVD 数据、adb key 等C:\Users\用户名\AppData\Local\Android\SdkSDK 本体C:\Users\用户名\AppData\Local\Google\AndroidStudio版本号IDE 日志、索引缓存。如果 C 盘是小容量固态建议把.gradle和Android\Sdk迁移到其他盘。.gradle迁移方式是设置环境变量GRADLE_USER_HOME指向新路径比如D:\Android\.gradle然后把原来的目录整体复制过去重新打开 Android Studio 即可。SDK 迁移方式更简单直接把文件夹复制到新路径然后在Project Structure - SDK Location里改一下指向。macOS 同理~/.gradle和~/Library/Android/sdk都可以通过符号链接或环境变量搬到其他卷。5.3 从 HelloWorld 到下一个项目路径别跑偏安装配置跑通不是终点只是起点。跑完 HelloWorld 之后我建议你按这个顺序继续深入试着改改界面布局熟悉XML里LinearLayout、ConstraintLayout的基本写法给 HelloWorld 加一个 Button点击之后通过Toast弹一段文字。这会迫你去了解 Activity、findViewById或ViewBinding、事件监听这些基础概念试试在真机上跑通一遍adb install、adb logcat的流程命令行里看日志会让你的排错能力上一个台阶再往后才是 Jetpack Compose、网络请求、数据库这些进阶内容。我个人经历里的一个体会是很多人卡在环境配置这一关其实不是笨而是教程里大量本该讲清的概念被一句话带过了。比如 “SDK 和 JDK 到底什么关系” “Gradle 为什么要联网” 这些底层逻辑一旦理解透了装环境就只是按部就班的事情。希望这篇内容能帮你少走一些我当年走过的弯路一次把环境配好。最后再分享一个小技巧把gradle-wrapper.properties和settings.gradle的镜像配置提交到 Git换电脑、换同事协作时能少受很多折腾。
