想入坑 Android 开发第一件绕不开的事就是安装 Android Studio。作为一个跟各种开发环境打过多年交道的人我可以说这个工具本身的安装门槛不高但周围坑并不少——SDK 组件下载慢、Gradle 初始化卡住、模拟器黑屏这三个问题已经劝退了大量新手。这篇入门教程我会把安装前的准备、完整安装步骤、SDK/JDK/路径配置、第一个项目怎么跑起来以及我踩过的坑全部过一遍。这篇内容主要面向第一次接触 Android Studio 的新手也适合那些装过几次但总是遇到诡异问题的朋友。我会以 Windows 平台为主兼顾 macOS 和 Linux 的关键差异。读完你应该能独立安装、配置环境、创建第一个项目并且知道遇到常见报错时该从哪个方向排查。1. 安装前的准备先想清楚这几件事很多新手犯的第一个错误不是安装步骤不对而是没想清楚自己要装什么、装在哪、装哪个版本。准备工作做得好后面能省掉一大半麻烦。1.1 硬件条件与磁盘规划Android Studio 本质上是一个基于 JVM 的大型 IDE再叠加 Android SDK、模拟器和 Gradle 构建系统它比普通文本编辑器要吃资源得多。别被“安装包只有 800 兆”迷惑装完之后会陆续下载大量系统镜像和构建工具。我的建议配置如下低于这个标准不是完全不能用但体验会非常难受配置项最低要求推荐配置说明内存8 GB16 GB 以上模拟器一开内存立刻见底磁盘空闲8 GB50 GB 以上SDK、系统镜像、Gradle 缓存都在膨胀CPU双核 x86_64四核以上必须支持虚拟化否则模拟器很难跑操作系统Windows 10 64 位Windows 10/11 64 位macOS 建议 11 以上Linux 看发行版屏幕分辨率1366x7681920x1080 以上高分屏需要调整缩放否则界面发虚磁盘规划这块我强烈建议不要全部塞进 C 盘。SDK 默认路径在系统用户目录下项目默认也在用户目录下两个加起来特别容易膨胀。安装前先在其它盘专门建一个开发目录比如D:\AndroidDev下面分几个子目录D:\AndroidDev |-- AndroidStudio # IDE 本体安装目录 |-- AndroidSdk # SDK 根目录 |-- AndroidProjects # 项目代码目录这样做的好处很实际重装系统时不用重新下载 SDK单独清理某个目录也不容易误删项目文件。我把这个习惯保持到现在每次重配环境都省了很多时间。1.2 版本选择稳定版还是预览版Android Studio 的版本更新节奏比较固定大版本号从 2020 年开始按年份和版本迭代。官网上通常提供两个选项稳定版和预览版Canary/Beta。新手直接下载稳定版就对了看到文件名里带有beta、rc、canary这类字样的一律绕过。预览版是为了体验新功能准备的经常伴随插件兼容问题、Gradle 版本冲突甚至是模拟器启动失败。曾经有朋友为了界面上的某个新特性装了预览版结果项目同步直接爆出几十个错误最后灰头土脸地退回稳定版。下载渠道认准 Android Studio 的官网就可以。注意看文件后缀Windows 是.exemacOS 有 Intel 和 Apple Silicon 两种版本Linux 一般是.tar.gz。如果你不确定自己的 Windows 是 64 位还是 32 位大概率是 64 位因为新版 Android Studio 已经不再提供 32 位版本。还有一个高频问题要不要下载带.dmg或.zip的绿色版不推荐。安装版能帮你写注册表、创建快捷方式、关联文件类型后续 SDK 路径和 JDK 检测也更省心。绿色版看着干净但各种路径检测会让你头疼。1.3 Java 环境到底要不要单独装这是新手最容易搞混的环节。老版本的 Android Studio 要求你提前装好 JDK但新版本已经内置了 JetBrains Runtime这是一个基于 OpenJDK 的运行时专门为 IDE 做了优化。也就是说你现在可以不装任何 JDK直接运行 Android Studio。但有一个容易踩的坑如果电脑里之前装过 JDK 8、JDK 11 或其他版本的 Java而且配置过JAVA_HOME环境变量Android Studio 可能会优先去读这个变量。一旦版本和 Gradle 需要的不匹配就会报各种稀奇古怪的错。我的建议是安装 Android Studio 的阶段先忽略 Java 环境冲突。如果后面遇到 Gradle 报错再进入项目的“Project Structure”面板单独指定 Gradle JDK 为 Android Studio 内置的运行时即可。这个我后面会展开说。2. Windows 安装与首次启动全流程Windows 平台是大多数新手的首选用 Windows 讲故事能把大部分通用问题讲清楚。这一章从下载安装包开始一直讲到首次启动配置完成。2.1 下载安装包与安装目录规划在官网点下载之后等待一个几百兆的.exe文件下载完成。下载速度可能不稳定这不是文件损坏耐心等就好。如果你下载完发现文件只有几十兆或者双击后提示格式不正确那多半是下载中断了建议删掉重下。双击安装包后第一屏一般是欢迎页和组件选择。很多新手会一路狂点“Next”然后等到装完才发现所有东西都塞进了 C 盘。正确做法是在第一步就点开安装路径设置把前面规划好的D:\AndroidDev\AndroidStudio填进去。注意安装路径不要包含中文也不要包含空格和特殊符号。比如D:\开发工具\Android Studio这种路径在某些插件和原生代码模块编译时会产生难以排查的问题。原因在于很多底层工具链对路径的解析并不统一中文路径会导致编码处理和文件定位出现偏差。安装过程中会出现几个安装类型选项一般情况下选“Standard”标准安装即可。它会自动安装默认的 SDK 组件和虚拟化驱动虽然并不是最全但已经足够跑起来。如果后续需要更多组件通过 SDK Manager 再补装也不迟。2.2 安装过程的每一步该选什么Windows 安装界面里经常出现的几个选择我说一下实际经验“安装位置”改成你规划的路径不要用默认的C:\Program Files\Android\Android Studio。虽然这不是强制要求但如果以后需要看 SDK 或模拟器的日志你会发现路径越短越好。“选择组件”标准安装会包含 Android SDK、Android Virtual Device 和性能监控等模块。如果要省空间可以先不选“Android Virtual Device”等真正需要模拟器时再安装但新手往往很快就要用到模拟器所以建议全选。“开始菜单”文件夹默认就行不用改。“是否导入旧设置”第一次安装选“Do not import settings”就行。之前装有旧版本且配置文件混乱的情况下不要导入干净点更省心。安装完成后先不要急着启动。建议先重启一次系统这样安装程序写入的环境变量和驱动配置才能充分生效。如果你装完立刻启动有概率遇到 SDK 路径识别不到的问题。2.3 首次启动配置SDK 组件与主题选择第一次启动 Android Studio会进入欢迎向导。这个向导不是摆设它会帮你下载最初的 SDK 平台组件并生成本地配置文件。接下来按顺序处理第一屏问你是否导入旧设置选“不导入”。第二屏可能会有数据分享和隐私设置建议选择不发送统计数据但这不是必须的。第三步选择 UI 主题深色或浅色都可以。主题只是审美问题和功能没有关系唯一要说的是深色主题看久了确实没那么刺眼。接下来最关键的一步是 SDK 组件的下载。向导会让你确认 Android SDK 的位置和组件。把 SDK 路径改成非 C 盘的路径比如D:\AndroidDev\AndroidSdk并勾选需要的平台组件。这里有非常重要的一点不要贪多只需要勾选最新稳定版本的 Android SDK Platform比如 Android 15 对应的 API 35 那一档具体以你创建项目时选择的版本为准其他旧版本等用到时再装。这一阶段的下载可能会持续十几分钟甚至更久。下载速度完全取决于你的网络对海外服务器的连通情况。如果卡在一个组件上长时间没反应不要强行关掉程序先看日志再判断。强行关闭很容易留下一个半成品 SDK之后还要手动清理。2.4 macOS 安装补充要点macOS 用户下载到的是.dmg文件安装动作很简单打开镜像把Android Studio.app拖进 Applications 文件夹。首次打开时需要确认来自“已标识开发者”这个正常点允许就行。macOS 平台有两个额外注意点。第一Intel 芯片和 Apple Silicon 芯片的下载包不一样下载前看清楚你的电脑是哪种芯片选错了可能会出现兼容性提示。第二macOS 默认对软件来源校验得很严格如果提示文件已损坏或无法验证开发者先检查是不是下载不完整。首次启动时同样会进入 SDK 组件下载向导路径规划思路和 Windows 一样建议把 SDK 放到用户目录之外的独立位置或者至少把名字改好记一些。后续的配置流程基本一致。3. SDK、路径与 JDK 的底层配置安装完 IDE 只完成了一半另一半是 SDK 和路径配置。很多“启动失败”问题根因都出在这一部分。3.1 Android SDK 目录里都有什么新手看到 SDK 目录里一堆英文文件夹容易发懵其实这些组件的分工非常清晰目录名作用什么时候会用到platforms各 Android 版本的系统 API 和框架文件创建项目或编译时按需加载build-tools打包、编译、签名等构建工具每次 apk 构建都会用到platform-toolsadb、fastboot 等调试工具连接真机、查看日志必备emulator模拟器主程序启动 AVD 时调用system-images各版本模拟器的系统镜像创建 AVD 时使用cmdline-tools命令行工具集合用命令行管理 SDK 时使用extras一些辅助驱动和扩展包硬件加速等场景使用记住一个通俗类比platforms像借书卡决定你能用哪个版本的“书”build-tools像印刷机帮你把代码变成安装包platform-tools像万能遥控器让你能指挥真机或模拟器执行指令。了解这些目录有什么用当构建报错提示缺少某个build-tools版本时你就能去 SDK Manager 里精准安装而不是瞎点重装整个 IDE。3.2 手动指定 SDK 路径与环境变量首次向导如果下载顺利SDK 路径会被写入 IDE 配置。但有的人喜欢移动 SDK 目录或者下载过程失败了这时候需要手动指定。打开 Android Studio按Ctrl Alt S进入设置在搜索框输入SDK找到“Android SDK”面板。面板顶部显示的 SDK 路径就是当前 IDE 使用的路径可以点右侧的 Edit 按钮修改。修改完成后可能需要重新启动 IDE。环境变量方面建议把ANDROID_HOME指向 SDK 根目录再把platform-tools目录加入PATH。Windows 下操作如下右键“此电脑” - 属性 - 高级系统设置 - 环境变量。在系统变量里新建变量名ANDROID_HOME变量值D:\AndroidDev\AndroidSdk。编辑PATH变量新增一行%ANDROID_HOME%\platform-tools。设置完成后新开一个命令行窗口输入adb version如果能正常输出版本号说明环境变量配置成功。配置ANDROID_HOME的原因很简单很多命令行工具和第三方构建脚本会直接读取这个变量如果没有它会出现“找不到 SDK 路径”的报错。3.3 Gradle 使用的 JDK 与项目级配置Gradle 是 Android 项目背后的构建引擎它对 JDK 版本有明确要求。Android Studio 内置的 JBR 通常能满足要求但如果你机器上有多个 JDK就需要在项目里指定。打开 Android Studio 后进入File-Project Structure-SDK Location或者在项目视图里按Ctrl Alt Shift S打开项目结构。在“SDKs”页面里能看到当前项目使用的 JDK。这里我建议选择 Gradle JDK 为 Android Studio 提供的嵌入式 JDK而不是系统 JDK。为什么这样选系统 JDK 可能是你以前装数据库或跑 Java 服务时留下的版本很可能是 JDK 8 或 JDK 17。Gradle 8 及以上需要 JDK 11 或 17 的支持版本不匹配就会看到类似Unsupported class file major version的报错。让 IDE 用自己的内置运行时能避免这种环境变量污染。如果你还想从命令行跑 Gradle那就需要单独配置一个符合版本要求的 JDK并在项目根目录的gradlew.batWindows或gradlewLinux/macOS脚本中使用它。不过这是后话新手阶段先把 IDE 里的构建跑通更重要。4. 创建第一个项目并启动模拟器环境配置完成是时候创建一个 Hello World 项目了。这一步会把前面的所有配置串起来也是新手建立信心的关键时刻。4.1 新建项目的关键选项怎么选在欢迎页点击“New Project”会看到很多模板分类。第一节课别选那些带复杂动画或分层架构的模板选 “Empty Views Activity” 或 “Empty Activity” 就够了。名字里带 “Compose” 的模板会引入全新的界面构建方式虽然很现代但对第一次接触 Android 的人来说概念负担太重。接下来进入项目配置页注意四个字段Name项目名称只能用字母、数字、下划线且不能以数字开头。比如HelloWorld。Package name应用包名格式是com.你的域名.项目名。没有域名时用com.example.helloworld也没问题但如果以后要上架应用需要改成你拥有的域名反过来写。Language选 Kotlin 还是 Java。新项目强烈建议 Kotlin这是目前 Android 官方主推的语言案例多、语法简洁。如果后续要维护老项目可以选 Java。Minimum SDK最低支持的 Android 版本。新手选 API 24 或更高就可以了对应的系统是 Android 7.0。这个值选得越低兼容性越广但需要额外处理很多旧版本特有的兼容逻辑选得太高又会丢掉大量真机用户。这些字段后面都能在项目配置里改但包名和项目名不建议频繁修改因为会牵扯到目录和构建文件的关系。4.2 Gradle 首次构建为什么会等很久点击“Finish”后Android Studio 会开始创建项目并触发 Gradle 同步。第一次同步往往是最漫长的它要做三件事下载 Gradle 发行版、下载项目依赖、初始化本地构建缓存。Gradle 发行版的下载地址隐藏在项目根目录的gradle/wrapper/gradle-wrapper.properties文件里内容大致长这样distributionUrlhttps\://services.gradle.org/distributions/gradle-8.9-bin.zip第一次同步时IDE 会在这里读取下载地址把对应版本的 Gradle 压缩包下载到本机用户目录下的~/.gradle/wrapper/dists目录中。这个压缩包动辄一百多兆下载速度直接影响你的等待时间。如果你的网速不太理想有一个实用办法用浏览器手动打开上面那个distributionUrl地址把压缩包下载回来然后放置到~/.gradle/wrapper/dists目录下对应版本的子目录里。放置时注意路径结构Gradle 会在解压后生成名为哈希值的子目录你可以在执行首次同步后看到目录创建出来再把压缩包放进去然后重新同步。这个方法不需要任何额外工具只是用浏览器替换 IDE 内部的下载器我实测下来很管用。同步过程中底部状态栏会显示进度有时会卡在Running Gradle task很久这不一定代表失败。多观察一段时间的日志再决定要不要干预。4.3 创建 AVD 模拟器镜像与运行参数项目能构建之后下一步就是把应用跑起来。选择模拟器之前打开 Device Manager通常在右上角点击 “Create Virtual Device”。设备定义列表里有很多手机和平板型号选一个屏幕尺寸适中的比如 Pixel 系列里某个中等尺寸机型分辨率不用选最高。确认设备后进入系统镜像选择界面这里只推荐下载标记为 x86_64 的系统镜像。下载镜像也可能很慢因为它体积通常在 1GB 到 2GB 之间。镜像下载完成后会进入 AVD 配置页。这里有几个参数要留意AVD Name模拟器名称方便识别比如Pixel_API_34。Startup size and orientation方向设置平板默认横屏手机默认竖屏。Advanced Settings里的 RAM 和 VM heapRAM 建议调到 2048 MB 以上如果你电脑内存足够给到 4096 MB 也合理。RAM 太低应用加载会很慢甚至直接闪退。启动模拟器时如果弹出硬件加速不支持的提示不要直接点“继续用软件渲染”然后放弃这个我下一章单独讲。首次启动模拟器通常比较慢黑屏一两分钟是正常的因为系统在冷启动。如果超过五分钟还是黑屏就可以按后面的排查思路处理了。4.4 用真机调试代替模拟器如果你的电脑性能一般又恰好有一台 Android 手机用真机调试是更稳的选择。真机调试省去了系统镜像下载和硬件加速的麻烦而且很多传感器相关功能只有在真机上才能测试。设置步骤非常简单在手机上打开“设置”找到“关于手机”或“关于平板”。连续点击“版本号”七次左右直到提示“已进入开发者模式”。返回设置首页找到“开发者选项”打开“USB 调试”开关。用数据线连接电脑手机弹出的“允许 USB 调试”弹窗里勾选“始终允许”然后点击确定。连接成功后会看到 IDE 右上角出现设备列表。如果你的手机没有出现多半是adb驱动问题或数据线只支持充电不支持数据传输换一根线通常能解决。真机调试最大的好处是应用构建完直接安装到手机不需要等待模拟器冷启动。5. 安装与初始化期间的常见问题排查这一章是全文最值得收藏的部分。我整理了一些我在安装和初始化阶段遇到过、也帮助别人解决的问题按症状分类方便你对照查找。5.1 SDK 下载卡住或失败症状是向导或 SDK Manager 停留在 “Downloading” 很多分钟进度条几乎不动。这可能是因为网络连通性不佳也可能是因为组件的下载域名在部分地区连接不稳定。排查思路先看日志。安装向导或 SDK Manager 底部有隐藏日志输出按Ctrl Shift 空格或查看 Log 面板能看到当前正在下载的 URL 和重试次数。如果日志里反复出现超时或重置说明下载链路未被阻断但极其缓慢。处理办法有三种按优先级尝试不直接关闭程序先用“Cancel”或“Stop”停止当前下载然后重新触发同一步骤有时重试会换一个下载节点。换个网络环境。比如从 WiFi 切换到有线网络或者换一个热门时段再下载。对于大体积系统镜像用浏览器访问日志里显示的 URL 手动下载然后放到对应组件目录。这不改变 SDK 的整体结构只是让下载任务由浏览器完成。不要反复点击“Retry”并同时在多个窗口触发下载容易导致组件文件锁定。耐心处理通常都能解决因为这个下载组件本身设计得比较健壮只是耗时问题。5.2 Gradle 同步失败Gradle 同步失败的报错五花八门但新手遇到的绝大多数集中在两类Gradle 发行版下载失败和依赖库下载超时。第一类看日志里有没有Could not find gradle-xxx.zip或Connection reset。解决办法就是前面提到的手动下载发行版压缩包再丢进 wrapper 目录。第二类失败时报错里经常出现某个域名和一堆堆栈信息这说明依赖下载连通性不稳。这种情况下常见的临时方案是关闭安全软件或把项目目录、SDK 目录加入信任区域。部分安全软件会扫描 Gradle 后台进程正在下载的临时文件导致网络请求被挂起。在构建配置里适当增加依赖下载的超时时间。修改项目根目录gradle.propertiessystemProp.org.gradle.internal.http.connectionTimeout180000 systemProp.org.gradle.internal.http.socketTimeout180000如果项目里引用了多个远程仓库可以调整仓库顺序把更易访问的仓库放在前面。但这已经属于进阶调整新手尽量别乱动。有一个必须坚持的原则遇到 Gradle 报错先看最上面的报错信息不要被一长串依赖堆栈吓到。真正的错误原因往往在前 10 行。5.3 模拟器黑屏、闪退或无法启动模拟器黑屏的常见原因有三个系统镜像下载不完整、RAM 分配过低、或显卡渲染模式不兼容。先解决系统镜像问题。打开 SDK Manager找到System Image分类确认对应 API 版本的镜像状态是“Installed”。如果状态异常卸载后重新安装一次。RAM 分配过低的表现为模拟器窗口起来了但一直停留在开机动画或黑屏。编辑 AVD把 RAM 提升到 2048 MB 以上。同时如果模拟器启动后闪退查看事件日志中是否有The emulator process for AVD ... has terminated。这种闪退多半是磁盘空间不足或显卡驱动问题可以尝试将 AVD 的 Graphics 选项改为 Software。用命令行启动模拟器也能绕过一些图形配置问题emulator -avd 你的AVD名称 -gpu swiftshader_indirectswiftshader 是纯软件渲染性能比 GPU 加速差一些但兼容性极强。在排除显卡驱动问题的时候非常好用。5.4 CPU 虚拟化与硬件加速设置模拟器运行必须依赖 CPU 虚拟化技术。在 Windows 上如果你遇到HAXM is not installed或Hypervisor required类提示大概率是虚拟化没开启或相关驱动没有安装。排查的顺序打开任务管理器 - 性能 - CPU查看“虚拟化”状态是否为“已启用”。如果是“已禁用”需要进入 BIOS/UEFI 开启。重启电脑后按F2、Del或F10进入 BIOS寻找Advanced-CPU Configuration下的Intel Virtualization TechnologyIntel 平台或SVM ModeAMD 平台将其设为 Enabled。如果虚拟化已经启用还是提示缺少硬件加速打开“控制面板 - 程序 - 启用或关闭 Windows 功能”勾选“Windows 虚拟机监控程序平台”或“虚拟机平台”重启后再看。也可以通过 SDK Manager 安装 Android Emulator Hypervisor Driver然后手动安装它提供的驱动文件。虚拟机内安装 Android Studio 的体验会更差因为套娃虚拟化通常不被支持。如果你正打算在虚拟机里搞 Android 开发我建议放弃这个想法直接装双系统或换一台性能足够的宿主机。5.5 路径带中文或空格导致的项目异常这个问题隐蔽性很强。项目路径、SDK 路径、Gradle 缓存路径只要任何一个环节出现中文或空格都可能触发千奇百怪的编译错误。典型错误包括但不限于File not found: C:\Users\目录名\AppData\... invalid regular expression Could not find or load main class这类问题表面看起来根本不是路径问题但当你把所有常规手段都试过之后回来检查路径往往能找到答案。预防的办法只有一条所有开发相关目录全程使用英文字母、数字和下划线。用户名如果是中文那系统用户目录C:\Users\中文名是绕不开的你只能尽量把 SDK 和项目放到非用户目录下或者采用英文用户名账户。Windows 用户目录重命名风险大不如新建一个本地英文账户专门用于开发。6. 安装完成后的效率配置与体验优化装好、跑通第一个项目之后你可能还会遇到卡顿、项目加载慢等问题。这里再分享几个安装后立刻能做的优化让 Android Studio 用起来顺手很多。6.1 调大 Android Studio 的内存上限IDE 默认内存上限偏低当项目代码量上来后编码过程会频繁出现卡顿。Android Studio 基于 JVM 运行在帮助菜单里找到Edit Custom VM Options打开配置文件后可以调整堆内存-Xmx4096m-Xmx表示最大堆内存。如果电脑内存 16G设4096m是起步值如果电脑内存 32G设6144m或8192m也不会过分。改完之后重启 IDE 生效。同时可以调整文件编码换行符等基础设置但这不是急事。最重要的是别让 IDE 频繁执行磁盘交换所以内存调大后也要注意关闭不用的项目窗口。6.2 提前优化 Gradle 与模拟器配置在gradle.properties里可以开启构建并行和缓存这能显著提高多模块项目构建速度org.gradle.daemontrue org.gradle.paralleltrue org.gradle.cachingtrue org.gradle.jvmargs-Xmx2048m这里有两点经验第一org.gradle.daemontrue表示让 Gradle 后台进程常驻避免每次构建都冷启动第二org.gradle.jvmargs里设置的堆内存和 IDE 的Xmx是两回事别互相混淆。模拟器方面如果一台电脑上经常要开多个 AVD建议只给当前项目使用的那台设备分配较高资源。不用的模拟器不要挂着后台模拟器会持续占用 CPU。6.3 建议养成的几个开发小习惯最后说几个我踩过坑后养成的习惯不一定每个都适合你但都值得试试。一是定期用 SDK Manager 清理未使用的 Android 版本。系统镜像是磁盘空间大户旧镜像如果长期不用卸载后能释放不少空间等需要时再下回来也方便。二是进入正式开发前先检查一下File - Settings - Build, Execution, Deployment - Build Tools - Gradle看清楚 Gradle JDK 有没有被意外切换成系统旧版本。这个配置在某些项目同步后会自动变化遇到同步异常先回来看看。三是每次新建项目时注意看右下角的 Gradle 同步提示不要一口气打开多个新项目。IDE 同时处理多个 Gradle 同步时很容易出现资源竞争和诡异的错误。最后说点实践中的体会。安装 Android Studio 从来不是“双击下一步”就完事的事它牵涉到 SDK、JDK、Gradle、模拟器驱动这些环环相扣的东西。新手阶段不必追求把所有原理一次搞懂先把环境跑通、把第一个 Hello World 装上后面再慢慢消化每个组件的作用。遇到问题也别慌几乎所有安装疑难杂症都已经在日志里有迹可循。先读日志再百度或搜索报错原文这个排查顺序能帮你省下大量时间。希望这份教程能让你少走一些我当年走过的弯路。
