1. 动手前先想清楚：你缺的不是教程，而是正确的环境认知
说实话，移动开发入门这件事，卡住大部分新手的往往不是代码，而是第一步的环境搭建。Android Studio 装到一半报错、SDK 下载卡住、模拟器起不来、Gradle 同步失败——这些坑我当年一个没落下，带新同事时也看他们一个个重新踩一遍。所以这篇东西我不打算写成一板一眼的安装说明书，而是把整个搭建过程拆开，告诉你每一步为什么要这么做、哪些坑可以提前绕开，以及遇到问题时怎么排查。
这篇内容适合完全没装过 Android Studio 的纯新手，也适合那些“装过但没跑通”的人。主题就是三件事：安装一个可用的 Android Studio、创建第一个能跑起来的项目、把这套环境调到你愿意天天用的状态。看完之后你应该能独立完成从下载到真机/模拟器运行一个 App 的完整闭环。
先说一个很多人不知道的背景知识：Android 开发环境和传统 PC 软件开发有个很大的不同——它依赖的东西不止一个 IDE，而是一整条工具链。这条链上包括 JDK（Java 开发套件）、Android SDK（系统库和编译工具）、Gradle（自动化构建工具）、模拟器镜像或真机驱动，以及 Android Studio 这个把所有东西串起来的图形界面。任何一个环节版本不匹配，都会以各种奇奇怪怪的报错形式出现在你面前。理解了这一点，后面遇到问题你就不至于慌了——绝大多数报错，本质上都是这条链上某个环节没配对。
我在下文会按实际动手顺序来写，而不是按理论体系来写。跟着操作就好，不用先去背概念。
1.1 “开发环境”到底包含哪些组件
Android Studio 安装包本身只是一个外壳，真正干活的是 JDK、SDK 和 Gradle 这三样东西。用做饭来类比：Android Studio 是厨房的灶台和锅铲，JDK 是燃气（底层运行能力），SDK 是食材和调料（系统提供的各种 API 和工具），Gradle 则是你手里那张菜谱加一个自动帮你备菜的小工。
- JDK（Java Development Kit）：运行 Android Studio 本体和编译 Java/Kotlin 代码都需要它。好消息是新版 Android Studio 已经内置了 JBR（JetBrains Runtime），基于 OpenJDK 定制，你不用单独去 Oracle 下载 JDK，这一点对新手极其友好。
- Android SDK：包含 android.jar（系统 API 库）、Build Tools（编译和打包工具）、Platform Tools（adb 等调试工具）、模拟器镜像等。它和 Android Studio 是分开的，理论上可以独立升级。装的时候默认会下载最新稳定版，基本够用。
- Gradle：负责把源码、资源、依赖库打包成 APK 的构建工具。Android Studio 自带了一套 Gradle wrapper，它会按项目配置自动下载对应版本的 Gradle 到用户目录。第一次新建项目时最大的耗时点就在这里。
现在的 Android Studio 安装流程已经把这些东西的 80% 自动化了，新手不需要手动配置环境变量，不需要单独下载 SDK——除非你要用命令行工具做自动化构建。所以，记住一句话：新手阶段，安装器让你点什么就点什么，不要自作聪明去改高级配置，很多环境问题都是改出来的。
1.2 下载安装包时的版本选择策略
去官方网站下载时，你会看到 Stable（稳定版）、Beta（测试版）、Canary（金丝雀版，内测尝鲜）几种通道。新手只认一个：Stable 稳定版。Beta 和 Canary 功能新但是会有各种不稳定因素，不适合作为学习环境。你学的是移动开发，不是给 Android Studio 当测试员。
下载时注意选择对应操作系统的安装包：
| 操作系统 | 选择的安装包 | 说明 |
|---|---|---|
| Windows | .exe 或 .zip | .exe 带引导界面，推荐新手使用；.zip 是绿色版，解压即用但后续配置略麻烦 |
| macOS | .dmg | 英特尔芯片和 Apple Silicon 芯片都是同样的包，Studio 会自动适配，但也要确认系统版本大于 11 |
| Linux | .tar.gz | 解压到固定目录，从命令行启动，配合桌面快捷方式使用 |
还有两个细节容易踩坑。第一个是安装路径：Windows 下尽量别装到 C:\Program Files，也别用任何带中文或空格的路径，曾有人因为路径里有中文导致 SDK 相关工具无法正常运行，排查了半天。建议直接建一个干净的目录，比如 D:\AndroidStudio 或者 C:\Android。第二个是系统要求：Windows 10/11 64 位是必须的，内存最低 8GB，但说句实在话，8GB 开模拟器会很卡，16GB 是舒服的底线。
下载慢的问题：Android Studio 发行包通常在 1GB 左右，不同网络环境下差异很大。如果你在官网下载遇到速度极慢或频繁中断的情况，可以换一个时段（比如清晨）再试，或者选择国内高校、开源镜像站点下载，注意核对文件完整性和版本号即可。不建议用下载工具开多线程硬拉，反而容易导致包损坏，装到一半报错。下载完成后先核对一下文件大小和官网标注是否一致，再开始安装。
2. 安装过程全解：不同系统的操作要点与避坑记录
这里分别写 Windows 和 macOS 的安装流程，这是绝大多数读者的环境。Linux 的流程类似，后面单独提重点差异。
2.1 Windows 安装流程与关键选项
Windows 的安装器其实就是把你选的组件解压到指定目录，然后帮你创建桌面快捷方式和环境变量引用。流程很短，重点在两处：安装类型和SDK 组件位置。
双击 .exe 后，首先进入 Welcome 界面，选择 Custom 可以自定义安装路径，建议新手也用 Custom，就改一个路径而已，其他不用动。接下来会要求指定 SDK 的位置，默认在%LOCALAPPDATA%\Android\Sdk，这个可以保留默认。很多人打算把 SDK 放到别的盘，这个没问题，但如果后面你要做命令行开发，就得自己去配 ANDROID_HOME 环境变量，属于可做但没必要——至少新手阶段没必要折腾。
安装过程中有一个步骤是选择 Android Virtual Device（模拟器镜像），勾选一个即可。默认的授权条款直接同意，然后开始安装。这一步会花几分钟，取决于硬盘速度。
安装完成后首次启动，会有一个“导入设置”的窗口：如果你之前没用过 IntelliJ IDEA 等 JetBrains 系工具，直接选 Do not import settings。这里有个很实际的问题：如果用旧版本 Studio 的设置，某些插件缓存、界面偏好可能和新版本不兼容，在新手期没必要冒这个风险。
首次启动时，Studio 会尝试联网获取最新的 SDK 组件。如果你的网络环境对国外站点不太友好，有时候这里会卡很久。我的建议是：给这个窗口五分钟耐心，如果超过十五分钟还在转圈，关掉 Studio 重新打开，有时候只是第一次初始化拉取的元数据比较多，不是死机。如果反复失败，再考虑手动处理（后面 SDK 管理一节详细写）。
2.2 macOS 安装流程与 Apple Silicon 注意事项
macOS 用户拿到的是 .dmg 文件，双击打开后把它拖到 Applications 文件夹。第一次打开时系统会提示“是从互联网下载的应用，是否确认打开”，因为 Studio 的签名和公证通常是完备的，右键点击应用选择“打开”即可绕过这个拦截。
Apple Silicon（M1/M2/M3 等）芯片的用户要注意一个关键差异：模拟器镜像只推荐运行 arm64 版本的系统镜像，而不是 x86_64 镜像。早期很多人为了兼容旧教程，强行跑 Intel 镜像，性能差且容易卡死。现在 Android Studio 新版本在创建模拟器时会自动推荐匹配芯片架构的镜像，你顺着默认走就行，不需要手动调整。
macOS 下安装完成后，同样会进入首次启动流程。SDK 默认位置在~/Library/Android/sdk，这个路径不用改。后续所有操作和 Windows 基本一致，只是快捷键从 Ctrl 换成 Cmd。
Linux 用户：解压 tar.gz 到/opt或~/software目录，然后运行bin/studio.sh。Linux 上如果缺一些图形库，可能会出现界面启动失败，通常需要安装libc++、libx11等依赖。这部分属于另一个话题，这里不展开。
2.3 首次启动后的 SDK 组件管理
首次启动完成后，你会看到欢迎界面，找到右下或侧边栏的 Configure，选择 SDK Manager，进入 SDK 管理面板。这里有两个页签：SDK Platforms（平台版本）和 SDK Tools（工具）。
SDK Platforms：勾选你项目要用的 Android 版本。新手不需要每个版本都装，装最新稳定版加你手头设备对应的版本就行。版本号后面会标注 API Level，下载后会占用几 GB 空间。
SDK Tools：默认会勾选 Android SDK Build-Tools、Android SDK Platform-Tools、Android Emulator 等，保持默认即可。注意下方有一个 “Show Package Details” 选项，勾上后可以看到具体子版本。新手不用深入，因为 Studio 在创建项目时会自动把所需的最小工具版本补齐。
最关键的技巧是这一节，往下看：如果你因为网络原因，SDK 组件下载总是失败，可以考虑手动修改 SDK 下载源。SDK Manager 左下角有个 “Proxy Settings”，但更推荐的做法是直接打开 SDK 目录下的repositories.cfg文件，在里面添加国内可用的 SDK 镜像地址，然后重启 Studio。不过，这个操作需要你对自己使用的镜像源有足够把握，而且要注意镜像站的同步更新是否及时。稳妥起见，普通新手先用默认源多试几次，很多情况下只是网络抖动，重试能解决。
注意：千万别在 SDK Manager 里随便取消勾选已安装组件，Studio 对缺失的 Build-Tools 版本会很敏感，报错信息类似 “failed to find Build Tools revision x.x.x”，这种问题让新手心态崩溃，所以保持默认是最安全的策略。
3. 创建第一个项目：模板选择、Gradle 同步与项目结构认知
环境搭好了，接下来是创建项目。这一节会涉及你此后每天都在用的概念：Gradle 同步、项目结构、模块概念。
3.1 项目模板与语言选择
首次打开 Studio 的欢迎界面后，选择 New Project。你会看到一排模板：Empty Activity、Basic Activity、Bottom Navigation Activity 等。对于第一个项目，选择 Empty Activity（空活动），原因很简单：模板越复杂，生成的代码越多，新手越难分辨哪些是核心、哪些是脚手架。
模板选完后有两个关键配置：
- Language 选择 Kotlin：虽然 Java 依然可用，但 Google 已经把 Kotlin 作为 Android 开发的第一推荐语言，新项目模板的默认示例代码也是 Kotlin 写的。新手学 Kotlin 并没有额外的门槛，它比 Java 更简洁，看代码更容易理解意图。
- Minimum SDK（最低支持版本）：选择最低支持至 Android 5.0（API 21）或更高。这个值决定了你的 App 能在多老的系统上跑。选得太低，你需要额外处理兼容性问题；选得太高，覆盖的设备就少。新手期选 API 24 左右比较合适。
确认后 Studio 会开始创建项目，然后自动触发一次 Gradle 同步。这里就是新手最容易焦虑的地方之一：Gradle 同步期间会下载大量依赖，界面下方的进度条可能长时间没动静，或者显示 “Downloading” 卡住。别手动取消，给它时间。第一次同步下载的东西包括 Gradle 发行版本身、Android Gradle Plugin、Kotlin 插件、AndroidX 依赖库等，体积可能在几百 MB 到 1GB 之间，取决于网络状况。你可以打开用户目录下的~/.gradle/wrapper/dists看看，那里面就是 Gradle 下载缓存，确认它在持续增长，就说明在正常下载。
3.2 Gradle 同步慢的加速技巧与环境变量配置
Gradle 同步慢是新手最常抱怨的问题。除了网络因素之外，还有一个很多人忽略的点：Gradle 默认使用的是 JVM 的可用堆内存，如果你机器内存本身不大，构建可能频繁触发垃圾回收，表现为“转圈但 CPU 占用不高”。这时可以在gradle.properties文件里调整 JVM 参数：
org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m这一行是告诉 Gradle 最多用 2GB 内存来做构建。机器 16GB 内存的话，这个配置很合理；8GB 内存的机器，可以改成 1536m，预留空间给模拟器和 Studio 本体。注意不要超过 3GB，因为 Studio 自己也要吃内存。
另外还有一个不为人注意的优化：把 Gradle 的用户目录从系统盘挪出来。默认情况下，Gradle 缓存会写入C:\Users\你的用户名\.gradle，如果系统盘空间紧张，构建会频繁清理缓存反而变慢。在系统环境变量里新增GRADLE_USER_HOME，指向一个大空间目录，比如D:\GradleCache，然后重启 Studio 即可生效。这一步不影响项目代码，只改变缓存位置，属于一劳永逸的操作。
实际体验下来，我个人的建议是：不要一上来就追求“加速”，先把默认配置跑通一次。Gradle 下载的依赖会长期缓存在本地，第二次创建项目时同步速度会明显加快。很多新手因为第一次同步慢就各种改配置，反而引入了新的问题，得不偿失。除了 JVM 内存和缓存路径这两个收益最大的调整，其他花式加速手段等你有心研究了再折腾。
3.3 认识项目结构：哪些是你要关注的
项目创建完成、同步跑通后，你能在左侧看到一串文件。新手面对这么多目录容易懵，但其实你需要关注的只有几个：
app/src/main/java（或kotlin）：你的代码所在目录。新建项目后会有一个MainActivity.kt，这是 App 的入口页面。app/src/main/res：资源目录，放布局文件（layout）、图片（drawable）、字符串（values）等。界面的 XML 文件都在这里。app/build.gradle.kts：模块级构建脚本。你引入第三方依赖库时，就是往这个文件的 dependencies 块里加一行。AndroidManifest.xml：App 的系统配置文件，声明页面、权限和应用信息。
初学者看到gradle目录、settings.gradle.kts、build.gradle.kts这些文件先不用深究，它们是构建系统的控制文件，正常开发时不会频繁改动。
有个非常常见的现象：有人会在app/src/main/AndroidManifest.xml里改权限、改应用名，但找不到文件在哪，其实右侧有一个 “Project” 文件树视图，点击右上角的齿轮图标，把 “Show Members” 打开，就能看到隐藏文件。新手期还是建议保持默认视图即可。
4. 让 App 跑起来：模拟器创建、常见启动失败与真机调试
代码写完了，得看到运行结果才算环境闭环。这一节是实操中问题最多的地方，覆盖模拟器和真机两条路径。
4.1 创建安卓虚拟机的完整流程
Android Studio 顶部的工具栏有一个设备下拉列表，点击后会看到 “Device Manager”，这就是 AVD（Android Virtual Device）管理入口。
点击 Create Device，你会看到一系列设备定义（Pixel 系列、Nexus 系列等）。不要纠结，选一个 Pixel 系列的设备即可，屏幕尺寸对新手没有实质影响。下一步选择系统镜像：优先选带有 “Google APIs” 标识的稳定版镜像，比如 Android 13（API 33）或 Android 14（API 34）。注意右侧会显示镜像大小，通常 1-2GB，下载需要时间。
关键设置是 AVD 的配置项：
- Name：给模拟器起名，随意。
- Startup size and orientation：保持默认。
- Memory and Storage：RAM 建议 2048MB，虚拟机存储用默认的即可，SD card 可以不配。
- Device Frame：是否显示设备边框，对性能几乎没有影响，但关掉后模拟器看起来更清爽。
创建完成后，点击启动按钮（绿色三角）。第一次启动会经历完整的 Android 系统开机过程，可能长达数分钟，期间模拟器窗口可能显示黑屏或者 “Waiting for target device to come online”，这都是正常的，别去疯狂点击。如果超过 5 分钟仍然黑屏，再考虑是不是配置问题。
模拟器开机后，它会像一个真实的 Android 手机一样展示桌面。之后每次启动速度会明显加快，因为第一次是冷启动，后续有快照缓存。你可以按Ctrl+Shift+A（macOS 是Cmd+Shift+A）输入 “Restart” 来重启模拟器，这会清掉一些运行中的异常状态。
4.2 模拟器启动失败的排查：WHPX、HAXM、虚拟化与内存
这部分值得单独写，因为太常见了。模拟器本质上是在电脑上跑一个虚拟机，所以它依赖 CPU 的硬件虚拟化能力。Windows 上，这个能力叫 WHPX（Windows Hypervisor Platform）；在 macOS 英特尔芯片上，历史方案是 HAXM，现在也已迁移到 Apple 的 Hypervisor.framework 或 Virtualization.framework。
常见的启动报错和对应排查思路：
报错：Intel HAXM is required / WHPX is not installed。这说明 Windows 的虚拟化平台功能没启用。解决步骤是：打开“控制面板” -> “程序和功能” -> “启用或关闭 Windows 功能”，勾选 “Windows Hypervisor Platform” 和 “虚拟机平台”，重启电脑再试。注意，这个功能和 Windows 自带的 Hyper-V 可能存在冲突，如果开了 Hyper-V 仍然报错，尝试在 BIOS 设置中打开 Intel VT-x（不同主板叫法不同，可能叫 “Intel Virtualization Technology”），重启生效。如果是在公司的电脑上，这些 BIOS 选项可能被 IT 锁定，那就只能改用真机调试。
报错：Emulator: ERROR: x86_64 emulation currently requires hardware acceleration。这里的核心还是虚拟化没开或者被关闭。你可以用systeminfo命令在 Windows 上查看 “Hyper-V 要求” 一栏，里面的 “虚拟化固件中已启用” 是否为“是”，如果显示“否”，就要进 BIOS。
现象：模拟器窗口一直黑屏但进程在跑。多半是显卡渲染问题。打开 Device Manager，编辑 AVD，把 Graphics 从 Automatic 改为 Software（软件渲染），虽然会牺牲部分流畅度，但兼容性最好。如果你有一张独显但驱动版本很老，也可能导致硬件渲染失败，更新驱动反而比调软件更彻底。
现象：启动后立刻闪退或提示内存不足。检查一下 AVD 的 RAM 设置是否超过了物理内存的一半。比如电脑 8GB 内存，给模拟器分配 4GB 显然会崩，降到 1.5GB 才合理。同时关闭一些后台占用内存的程序（浏览器标签页、视频播放器等）。
提示：模拟器启动相关的报错信息五花八门，但 90% 都是虚拟化开启、内存分配、渲染模式三个原因之一。排查时按这个优先级来，不要一上来就重装软件。
4.3 真机调试：从 USB 连接到无线调试
如果你的电脑因为各种限制跑不了模拟器，真机调试是完全可行的替代方案，步骤也不复杂。
第一步，在手机上开启开发者选项。方法是打开“设置” -> “关于手机”，连续点击“版本号”7 次，系统会提示 “你已进入开发者模式”。然后在设置里找到“开发者选项”，打开 “USB 调试”。
第二步，用 USB 线连接电脑。手机端会弹出“是否允许 USB 调试”，勾选 “始终允许” 并确认。如果 Windows 上没有安装对应的 USB 驱动，设备管理器里手机会显示一个带黄色感叹号的项目。你可以下载手机厂商提供的 USB 驱动，或者安装一个通用的 Google USB Driver（在 SDK Manager 的 Extras 目录里能找到）。
第三步，Android Studio 里点击设备下拉框，如果能看到你手机的型号，直接运行即可。首次连接时，Studio 可能会询问是否信任这台电脑，确认即可。
Android 11 及以上还支持无线调试，适合 USB 口紧张的情况。手机和电脑连接同一 WiFi，在开发者选项里打开 “无线调试”，使用配对码配对，就能脱离数据线调试。具体步骤在手机和 Studio 界面上都有引导，这里不赘述。新手期我建议还是先用 USB 线，毕竟少一个变量。
4.4 把 Studio 设置成顺手的中文环境
很多新手看到满屏英文头大，设置中文界面是很合理的需求。新版 Android Studio 的语言切换其实已经内置了：进入Settings->Languages and Frameworks或者直接在设置里搜索 “Language”，把界面语言改为简体中文，重启 Studio 即可生效。如果你装的是英文版本且没有这个选项，那说明版本比较旧，可以通过Settings->Plugins搜索 “Chinese Language Pack” 安装语言包。注意：切换语言只是改变 IDE 界面文字，对项目代码没有影响，放心操作。
语言切换后有个小坑：部分搜索关键字、插件名在中文界面下不太好定位。不过顺手了之后其实影响不大。如果你决定留在英文界面，也完全可以，Android 开发资料绝大多数是英文的，早点适应不是坏事。这里不作强求，怎么舒服怎么来。
4.5 环境变量与 adb 命令行工具
调试过程中，你偶尔需要在命令行里直接执行adb install、adb logcat之类的命令。adb 是 Android Debug Bridge 的缩写，位于 SDK 的 platform-tools 目录下。它默认不在系统 PATH 中，如果你在终端里直接输入 adb 会提示“不是内部或外部命令”。
要解决这个问题，把platform-tools的完整路径添加到系统环境变量 PATH 中。Windows 的添加方式：此电脑右键 -> 属性 -> 高级系统设置 -> 环境变量，在系统变量的 Path 里新建一条，粘贴你的 SDK 路径下的 platform-tools 目录，比如C:\Users\你的用户名\AppData\Local\Android\Sdk\platform-tools。配置后用新开一个终端窗口输入adb version，看到版本号输出就说明成功了。
环境变量没配置也可以开发，Studio 内部已经知道 adb 在哪，不影响图形界面操作。但配置后你会更自由，比如后面讲到的命令行打包 APK，就需要这些工具。建议新手顺手配一下，一劳永逸。
5. 从代码到安装包：APK 编译与签名的完整过程
了解了如何运行调试，还有一个必经流程：把 App 编译成一个可以安装到手机上的 APK 文件。这个过程叫打包，里面最重要、也最容易让新手困惑的是“签名”。
5.1 签名到底是什么，为什么必须签
Android 系统要求每一个安装到手机上的 APK 都必须携带数字证书，也就是“签名”。它的作用相当于文件的指纹：证明这个 App 的身份，确保后续更新时是同一个开发者发布的，而不是别人伪造的版本。具体细节在深入开发后会接触到，但新手必须记住：没有签名的 APK 无法安装，用 debug 签名打包的 APK 和用 release 签名打包的 APK 也不能互相覆盖升级。
Android Studio 在运行调试时其实已经自动给你签过名了——用的是 debug keystore，所以你能在模拟器里安装。但要发布给其他用户安装，就需要创建自己的 release keystore，这是一个带密码的.jks文件，务必妥善保存，因为一旦丢失，已经发布过的 App 就无法再次升级（只能换包名重新发布，损失很大）。
5.2 生成签名 APK 的操作步骤
在 Studio 顶部菜单栏选择Build->Generate Signed Bundle / APK，弹出窗口里选择 APK（新手不需要了解 Android App Bundle 的差异）。点击 Next，进入 Key store path 界面。
如果之前没创建过 keystore，点击 “Create new”，填写：
- Key store path：选择一个保存目录，文件名可以取
release.jks。 - Password / Confirm：设置密码，最少 6 位，最好记到自己的密码管理器里。
- Alias：密钥别名，比如
release。 - Key Password：通常和 keystore 密码一致即可。
- Validity：默认 25 年，不要改。
- First and Last Name：你的名字，可以填公司名或个人名，这里不校验真实性。
填完后点击 OK，回到上一界面，密码会自动填充。之后选择 Build Type 为 release，记得勾选签名版本（Signature Versions），建议两个都勾选（V1 用于兼容 Android 7.0 以下，V2 用于 7.0 以上和更高版本）。“Release” 下还有一个 “Debug” 选项，如果你只是想在手机里自己玩玩，选 debug 也可以，但正式发布选 release。
点击 Finish 后，Studio 会执行一次构建，如果代码没有错误，几分钟后你会看到右下角弹窗提示 “APK 已生成”，点击提示里的 “locate” 可以直接打开 APK 所在目录。路径一般在app/build/outputs/apk/release/app-release.apk。
5.3 命令行构建与常见构建报错速查
除了图形界面，你还可以在 Studio 内置的终端（Terminal 窗口）里直接用命令行构建。项目的根目录下有 Gradle wrapper，对应的执行命令在 Windows 上是gradlew.bat，macOS/Linux 上是./gradlew。常用的构建命令：
./gradlew assembleDebug # 生成 debug 包 ./gradlew assembleRelease # 生成 release 包 ./gradlew clean # 清理构建产物 ./gradlew build # 完整构建并执行检查命令行构建的好处是输出日志更完整，排查问题时更容易定位。但新手初次接触时注意：一定要在项目根目录下执行，否则会提示找不到 Gradle 任务。
构建过程中常见的报错我整理成了下面速查表：
| 报错特征 | 常见原因 | 解决思路 |
|---|---|---|
| Could not find or load main class | Gradle JVM 配置异常 | 检查 JAVA_HOME 环境变量是否正确指向 Studio 内置 JBR 目录 |
| Failed to find Build Tools revision | SDK 组件缺失 | 打开 SDK Manager，安装 Build-Tools 对应版本 |
| Resource linking failed | 资源文件引用错误 | 检查res目录下 XML 文件是否有拼写或引用错误 |
| Duplicate class found | 依赖库冲突 | 检查 build.gradle.kts 里是否重复引入了功能相同的库 |
把这些坑过一遍后，你的 Android Studio 环境就算真正“通风”了——从代码到 APK 到安装到调试，每个环节都走通了。接下来就进入正常的开发学习节奏。
很多人问我，环境搭建到底学到什么程度才算合格？我的答案是：当你不再害怕报错，而是会按工具链的上下游去排查问题的时候，就算过关了。最后分享一个个人习惯：遇到搞不定的报错，先看完整的错误日志，而不是只看弹窗里的三行摘要。Studio 右下角的 “Build” 窗口会显示详细日志，把日志里从下往上数第一个标着FAILURE或ERROR的关键行复制到搜索引擎里搜，往往一条就有答案。这比截图问人要有效率得多。
环境搭好后，建议你给自己制定一个节奏：先照着模板写一个改文字、换图片的简单页面，跑起来，再尝试加一个按钮和点击事件，然后是跳转第二个页面。每一步都在模拟器上看到实际效果，你的成就感会持续推动你往前走，那时候就会发现，当初折磨你一整天的环境搭建，不过是移动开发这条路上最小的一道坎罢了。
