Android Studio安装配置全攻略：SDK、Gradle与模拟器问题排查

想入坑 Android 开发，第一件绕不开的事就是安装 Android Studio。作为一个跟各种开发环境打过多年交道的人，我可以说：这个工具本身的安装门槛不高，但周围坑并不少——SDK 组件下载慢、Gradle 初始化卡住、模拟器黑屏，这三个问题已经劝退了大量新手。这篇入门教程我会把安装前的准备、完整安装步骤、SDK/JDK/路径配置、第一个项目怎么跑起来，以及我踩过的坑全部过一遍。

这篇内容主要面向第一次接触 Android Studio 的新手，也适合那些装过几次但总是遇到诡异问题的朋友。我会以 Windows 平台为主，兼顾 macOS 和 Linux 的关键差异。读完你应该能独立安装、配置环境、创建第一个项目，并且知道遇到常见报错时该从哪个方向排查。

1. 安装前的准备：先想清楚这几件事

很多新手犯的第一个错误，不是安装步骤不对，而是没想清楚自己要装什么、装在哪、装哪个版本。准备工作做得好，后面能省掉一大半麻烦。

1.1 硬件条件与磁盘规划

Android Studio 本质上是一个基于 JVM 的大型 IDE，再叠加 Android SDK、模拟器和 Gradle 构建系统，它比普通文本编辑器要吃资源得多。别被“安装包只有 800 兆”迷惑，装完之后会陆续下载大量系统镜像和构建工具。

我的建议配置如下，低于这个标准不是完全不能用，但体验会非常难受：

磁盘规划这块，我强烈建议不要全部塞进 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 是.exe，macOS 有 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像借书卡，决定你能用哪个版本的“书”；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 下操作如下：

1. 右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量。
2. 在系统变量里新建：变量名ANDROID_HOME，变量值D:\AndroidDev\AndroidSdk。
3. 编辑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.bat（Windows）或gradlew（Linux/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文件里，内容大致长这样：

distributionUrl=https\://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 heap：RAM 建议调到 2048 MB 以上，如果你电脑内存足够，给到 4096 MB 也合理。RAM 太低，应用加载会很慢，甚至直接闪退。

启动模拟器时如果弹出硬件加速不支持的提示，不要直接点“继续用软件渲染”然后放弃，这个我下一章单独讲。

首次启动模拟器通常比较慢，黑屏一两分钟是正常的，因为系统在冷启动。如果超过五分钟还是黑屏，就可以按后面的排查思路处理了。

4.4 用真机调试代替模拟器

如果你的电脑性能一般，又恰好有一台 Android 手机，用真机调试是更稳的选择。真机调试省去了系统镜像下载和硬件加速的麻烦，而且很多传感器相关功能只有在真机上才能测试。

设置步骤非常简单：

1. 在手机上打开“设置”，找到“关于手机”或“关于平板”。
2. 连续点击“版本号”七次左右，直到提示“已进入开发者模式”。
3. 返回设置首页，找到“开发者选项”，打开“USB 调试”开关。
4. 用数据线连接电脑，手机弹出的“允许 USB 调试”弹窗里勾选“始终允许”，然后点击确定。

连接成功后会看到 IDE 右上角出现设备列表。如果你的手机没有出现，多半是adb驱动问题或数据线只支持充电不支持数据传输，换一根线通常能解决。真机调试最大的好处是，应用构建完直接安装到手机，不需要等待模拟器冷启动。

5. 安装与初始化期间的常见问题排查

这一章是全文最值得收藏的部分。我整理了一些我在安装和初始化阶段遇到过、也帮助别人解决的问题，按症状分类，方便你对照查找。

5.1 SDK 下载卡住或失败

症状是向导或 SDK Manager 停留在 “Downloading” 很多分钟，进度条几乎不动。这可能是因为网络连通性不佳，也可能是因为组件的下载域名在部分地区连接不稳定。

排查思路：先看日志。安装向导或 SDK Manager 底部有隐藏日志输出，按Ctrl + Shift + 空格或查看 Log 面板，能看到当前正在下载的 URL 和重试次数。如果日志里反复出现超时或重置，说明下载链路未被阻断但极其缓慢。

处理办法有三种，按优先级尝试：

1. 不直接关闭程序，先用“Cancel”或“Stop”停止当前下载，然后重新触发同一步骤，有时重试会换一个下载节点。
2. 换个网络环境。比如从 WiFi 切换到有线网络，或者换一个热门时段再下载。
3. 对于大体积系统镜像，用浏览器访问日志里显示的 URL 手动下载，然后放到对应组件目录。这不改变 SDK 的整体结构，只是让下载任务由浏览器完成。

不要反复点击“Retry”并同时在多个窗口触发下载，容易导致组件文件锁定。耐心处理通常都能解决，因为这个下载组件本身设计得比较健壮，只是耗时问题。

5.2 Gradle 同步失败

Gradle 同步失败的报错五花八门，但新手遇到的绝大多数集中在两类：Gradle 发行版下载失败，和依赖库下载超时。

第一类看日志里有没有Could not find gradle-xxx.zip或Connection reset。解决办法就是前面提到的手动下载发行版压缩包再丢进 wrapper 目录。第二类失败时，报错里经常出现某个域名和一堆堆栈信息，这说明依赖下载连通性不稳。这种情况下，常见的临时方案是：

• 关闭安全软件，或把项目目录、SDK 目录加入信任区域。部分安全软件会扫描 Gradle 后台进程正在下载的临时文件，导致网络请求被挂起。
• 在构建配置里适当增加依赖下载的超时时间。修改项目根目录gradle.properties：

systemProp.org.gradle.internal.http.connectionTimeout=180000 systemProp.org.gradle.internal.http.socketTimeout=180000

• 如果项目里引用了多个远程仓库，可以调整仓库顺序，把更易访问的仓库放在前面。但这已经属于进阶调整，新手尽量别乱动。

有一个必须坚持的原则：遇到 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_indirect

swiftshader 是纯软件渲染，性能比 GPU 加速差一些，但兼容性极强。在排除显卡驱动问题的时候非常好用。

5.4 CPU 虚拟化与硬件加速设置

模拟器运行必须依赖 CPU 虚拟化技术。在 Windows 上，如果你遇到HAXM is not installed或Hypervisor required类提示，大概率是虚拟化没开启或相关驱动没有安装。

排查的顺序：

1. 打开任务管理器 -> 性能 -> CPU，查看“虚拟化”状态是否为“已启用”。如果是“已禁用”，需要进入 BIOS/UEFI 开启。重启电脑后按F2、Del或F10进入 BIOS，寻找Advanced->CPU Configuration下的Intel Virtualization Technology（Intel 平台）或SVM Mode（AMD 平台），将其设为 Enabled。

2. 如果虚拟化已经启用，还是提示缺少硬件加速，打开“控制面板 -> 程序 -> 启用或关闭 Windows 功能”，勾选“Windows 虚拟机监控程序平台”或“虚拟机平台”，重启后再看。

3. 也可以通过 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.daemon=true org.gradle.parallel=true org.gradle.caching=true org.gradle.jvmargs=-Xmx2048m

这里有两点经验：第一，org.gradle.daemon=true表示让 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 装上，后面再慢慢消化每个组件的作用。遇到问题也别慌，几乎所有安装疑难杂症都已经在日志里有迹可循。先读日志，再百度或搜索报错原文，这个排查顺序能帮你省下大量时间。希望这份教程能让你少走一些我当年走过的弯路。