AndroidStudioHedgehog基础操作与项目创建教程

是不是升级到 Android Studio Hedgehog 版本后，看着全新的界面一脸懵？之前熟悉的按钮位置全变了，创建项目时弹出的选项也多了不少，好不容易点完 “下一步”，又提示 “Gradle 同步失败”？后台总收到新手留言：“Hedgehog 版本到底怎么用啊？还不如老版本顺手！” 其实啊，Hedgehog 作为 2023 年的稳定版，优化了不少功能，只是界面变了样，熟悉后操作会更顺。今天兔子哥就带大家搞定 Hedgehog 的基础操作和项目创建，从安装到运行第一个 APP，每个步骤都讲清楚，新手也能快速上手。

先搞懂：Hedgehog 版本有啥新变化？和老版本区别大吗？

很多同学习惯了老版本，一看到 Hedgehog 的界面就慌了。其实它只是优化了布局，核心功能都在，还加了不少实用工具。和之前的 Electric Eel 版本比，这些变化最明显：

兔子哥刚开始用 Hedgehog 时，也找不到 “AVD Manager” 按钮，后来发现藏在侧边栏的 “Device Manager” 里，改名了但功能没变。这些小变化适应两天就熟了，千万别因为界面变了就换回老版本，新功能真的能提高效率。

第一步：下载安装 Hedgehog，这 3 个细节别忽略

安装是第一步，看似简单，不注意细节容易出问题。

官网下载，别信第三方链接

打开浏览器搜 “Android Studio 官网”，认准带 “official” 的链接，进入后找到 “Hedgehog | 2023.1.1” 版本，点击 “Download”。注意这几点：

• 勾选 “Agree with the Terms” 才能下载，别漏看条款；

• 下载时用浏览器自带下载器，别用迅雷，容易下到损坏的安装包；

• 文件大小约 2.5G，提前预留好磁盘空间，建议下到非 C 盘。

之前有个同学图快，从某论坛下了 “绿化版”，结果缺了核心组件，重装官网版才解决。官网下载虽然慢，但最靠谱。

安装路径别乱选，组件一定要勾全

双击安装包，弹出界面后别一路点 “Next”：

1. 安装位置：点 “Browse” 选择路径，比如 “D:\Android\Android Studio Hedgehog”，路径里别用中文或空格，不然容易卡启动；

2. 组件选择：必须勾上 “Android Virtual Device”（模拟器）和 “Android SDK”，新手常漏勾模拟器，后面想运行 APP 都没工具；

3. 开始菜单文件夹：默认就行，方便后面找到软件。

点 “Install” 后等着进度条走完，安装时间根据电脑配置定，一般 15-20 分钟。安装完会提示 “Reboot now”，一定要重启电脑，不然很多组件不生效，这步能解决 80% 的 “安装后打不开” 问题。

第二步：认识界面，这 5 个核心区域先记牢

打开 Hedgehog 后，界面比老版本清爽，但按钮位置变了，新手先认准这 5 个区域：

1. 欢迎界面：常用功能全在这

第一次启动会显示欢迎界面，别直接点 “New Project”，先看看这些实用按钮：

• New Project：创建新项目（最常用）；

• Open：打开已有项目；

• Get from VCS：从 Git 拉取代码（暂时用不上）；

• More Actions：里面有 “SDK Manager”“AVD Manager”，找不到这两个工具时就点这里。

2. 工具栏：核心操作按钮

进入项目后，顶部工具栏是高频使用区，记这几个图标：

• 绿色三角形（Run）：运行当前项目；

• 绿色虫子（Debug）：调试项目；

• 大象图标（Sync Project with Gradle Files）：Gradle 同步，报错时先点这个；

• 搜索图标（Search Everywhere）：全局搜索，按两下 Shift 也能调出。

3. 侧边栏：项目文件和工具入口

左边侧边栏默认显示项目文件，点顶部的小图标能切换工具：

• Project：显示项目文件结构，新手重点看 “app\src\main”；

• Device Manager：管理模拟器，创建、启动模拟器都在这；

• Logcat：查看运行日志，找 bug 全靠它；

• Build：查看编译进度和错误信息。

4. 编辑区：写代码的主阵地

中间最大的区域就是编辑区，能同时打开多个文件，顶部标签栏可以切换。写布局时点右下角的 “Split” 按钮，能一边看代码一边预览效果，这个功能超实用。

5. 底部状态栏：显示项目状态

底部能看到当前分支、Gradle 状态、内存占用，同步或编译时会显示进度条，红色感叹号表示有错误，点一下能跳转到错误位置。
刚开始不用记所有按钮，用到哪个记哪个，就像用手机先学打电话再学拍照，慢慢就熟了。

第三步：创建第一个项目，Hedgehog 流程更简单

创建项目是核心操作，Hedgehog 把之前的多步弹窗改成了一站式表单，更方便了。

步骤 1：选模板，新手认准 “Empty Activity”

在欢迎界面点 “New Project”，会看到一堆模板，别乱选：

• 零基础直接选 “Empty Activity”（空活动），最基础的模板；

• 想做界面复杂点的可选 “Basic Activity”，自带顶部导航栏；

• 别碰带 “Compose”“Fragment” 的模板，那是进阶功能。

选好模板后点 “Next”，进入项目配置界面。

步骤 2：填项目信息，这几个选项别瞎改

项目配置表单要填对，不然后面运行报错：

• Name：项目名叫 “FirstHedgehogApp” 就行，好记；

• Package name：默认是 “com.example.firsthedgehogapp”，不用改，这是 APP 的唯一标识；

• Save location：选之前建的 “D:\Android\Projects” 文件夹，统一管理项目；

• Language：选 “Java”，新手用 Java 教程多，别选 “Kotlin”；

• Minimum SDK：选 “API 24”（Android 7.0），覆盖大部分设备；

• Build configuration language：默认 “Groovy”，别动它，改了容易同步失败。

填完后点 “Finish”，项目开始创建，底部会显示 “Building” 进度，第一次创建会下载 Gradle 和依赖，耐心等 5-10 分钟，别中途关掉。

步骤 3：解决同步失败，这 3 招最管用

同步失败是新手最头疼的问题，遇到了别慌，按这步骤排查：

1. 检查网络：Gradle 需要联网下载依赖，关了 VPN 试试，或连手机热点；

2. 清理缓存：点 “File→Invalidate Caches...→Invalidate and Restart”，清理后重启；

3. 换 Gradle 版本：打开 “gradle/wrapper/gradle-wrapper.properties”，把 “distributionUrl” 里的版本号换成老版本（比如 7.5），同步试试。

兔子哥遇到同步失败时，通常先点 “Sync Project” 按钮，不行就清理缓存，基本都能解决。

第四步：运行第一个 APP，模拟器和真机都能跑

项目创建成功后，该让 APP 跑起来了，看到 “Hello World” 就算成功。

用模拟器运行，Hedgehog 的模拟器更流畅

点侧边栏的 “Device Manager”，点 “Create device”：

1. 选设备型号，推荐 “Pixel 6”，大小适中，性能需求低；

2. 选系统镜像，点 “Download” 下载 “Android 13.0 (Tiramisu)”，稳定且兼容好；

3. 命名模拟器，点 “Finish” 完成创建。

启动模拟器时，Hedgehog 会提示 “Quick Boot”（快速启动），勾上后下次启动更快。模拟器启动后，点工具栏的绿色 “Run” 按钮，APP 会自动安装，过一会儿就能看到屏幕上的 “Hello World!” 了。

用真机运行，比模拟器快多了

如果电脑配置一般，模拟器卡得慌，用真机更方便：

1. 手机连电脑，打开 “设置→关于手机”，连续点 “版本号” 7 次，打开 “开发者模式”；

2. 回到设置，找到 “开发者选项”，打开 “USB 调试”，弹出提示点 “确定”；

3. 电脑上会弹出 “允许 USB 调试”，勾选 “始终允许” 后点 “确定”；

4. 顶部工具栏会显示你的手机型号，点 “Run” 按钮，APP 就装到手机上了。

真机运行不仅快，还能真实感受操作流畅度，兔子哥平时开发都用真机，新手推荐试试。

实用技巧：Hedgehog 这些功能别浪费

Hedgehog 有不少隐藏技巧，用好能省时间：

1. 快捷键 Alt+Enter：代码报错时按这个，会自动提示解决方案，比如 “导入类”“创建变量”；

2. 实时预览：写布局时勾上右上角的 “Auto-refresh”，改完代码预览窗自动更新，不用手动点刷新；

3. 快速修复：代码下有红线时，鼠标悬停会显示错误原因，点 “Fix” 能一键修复简单问题；

4. 模拟器快照：模拟器运行时，点 “Take Snapshot” 存快照，下次启动直接恢复到当前状态，不用等系统加载。

兔子哥最爱用 Alt+Enter，之前改代码时漏了导入类，按一下就自动加上了，比手动敲快多了。

常见问题解答，遇到了别慌

问：安装后打开提示 “JDK not found” 怎么办？

答：Hedgehog 自带 JDK，不用单独装。这问题通常是安装包损坏，删了重下官网版本，记得校验文件完整性。

问：创建项目时 “Minimum SDK” 选不了？

答：点 “Install SDK” 下载对应版本的 SDK，Hedgehog 默认只装最新版，老版本需要手动下载，在 “SDK Manager” 里勾上对应版本就行。

问：模拟器启动后黑屏，一直没反应？

答：先等 5 分钟，第一次启动慢正常；还不行就检查电脑是否开启 “虚拟化技术”（进 BIOS 开启 VT-x），开了虚拟化模拟器才跑得快。

兔子哥的使用心得

Hedgehog 虽然界面变了，但用熟后真的比老版本顺手，同步速度快了不少，模拟器也更稳定。新手别因为界面陌生就退缩，花半天时间熟悉按钮位置，后面开发会很顺。
安装时别省时间，选对路径、勾全组件，能避免很多后续问题；创建项目时选项别乱改，按教程的默认设置来，成功率更高；遇到同步失败别慌，先检查网络再清理缓存，大部分问题都能解决。
其实工具只是辅助，核心还是多动手练，哪怕每天创建一个简单项目，熟悉界面和操作，一周后就能熟练用 Hedgehog 开发了。希望这篇教程能帮你搞定新版本，别让工具成为学习的阻碍，动手试试吧，你会发现 Hedgehog 真的不难用！

标签： 一目了然 工具栏