2. 开发环境搭建：DevEco Studio的安装与配置、创建第一个HarmonyOS项目、项目结构解析
好，咱们正式开始动手了。
这一章，我会带你从零搭建起鸿蒙开发环境。说白了，就是先把“厨房”收拾利索，然后炒出第一道菜——你的第一个HarmonyOS项目。
我个人习惯是，不管学什么新东西，先把环境搞顺了，后面才能心不慌。你想想看，要是IDE动不动就报错，谁还有心思学下去？
2.1 DevEco Studio的安装与配置
DevEco Studio，是华为官方基于IntelliJ IDEA Community版定制的IDE。说白了，如果你用过Android Studio或者IDEA，上手会非常快。
2.1.1 下载与安装
去华为开发者官网，找到DevEco Studio的下载页面。注意区分Windows、macOS和Linux版本。我建议你下载最新稳定版，别追Beta版，容易踩坑。
- Windows用户：下载exe安装包，双击运行。记得勾选“添加到PATH”。
- macOS用户：下载dmg文件，拖到Applications文件夹就行。
- Linux用户：解压tar.gz，运行里面的studio.sh。
安装过程基本是下一步下一步，但有一个地方要注意——安装路径不要有中文和空格。我曾经因为路径里带了个“项目”两个字，导致编译死活过不去，折腾了半天才发现是路径编码问题。
2.1.2 SDK配置
安装完DevEco Studio，第一次启动会让你配置SDK路径。这里有个小技巧：
- 打开Settings → Appearance & Behavior → System Settings → HarmonyOS SDK
- 选择SDK版本。我个人建议API 9起步，因为API 8有些API已经过时了，API 10又太新，资料不多。
- 勾选“Ohos SDK”、“Toolchains”、“Previewer”三个组件。
嗯，这里要注意：SDK下载速度可能比较慢。如果你有代理，可以配置一下。没有的话，就耐心等吧，或者换个时间段再试。
2.2 创建第一个HarmonyOS项目
环境搭好了，咱们来创建第一个项目。这个过程我带你走一遍，你跟着做就行。
2.2.1 新建项目
点击“Create New Project”，你会看到一堆模板。别被吓到，咱们选最简单的：
- Empty Ability：最干净的模板，适合初学者。
- Application：普通应用。
- Stage模型：这是鸿蒙推荐的新模型，咱们就用这个。
选好后，填项目信息：
- Project Name：比如“MyFirstApp”
- Package Name：比如“com.example.myfirstapp”
- Save Location：选个好记的目录
- Compatible SDK：选API 9
点击Finish，等它构建。第一次构建会下载一些依赖，可能会慢一点。喝杯咖啡，别急。
2.2.2 运行项目
项目创建好后，怎么看到效果？有三种方式：
- 使用模拟器：点击工具栏的“Device Manager”，创建一个模拟器。我建议选P40 Pro的镜像，比较通用。
- 使用真机：用USB连上你的鸿蒙手机，打开开发者模式，就能识别到。
- 使用Previewer：这是DevEco Studio自带的预览器，不用开模拟器就能看到UI效果。开发阶段我基本都用它，快得很。
点击运行按钮，选择你的设备。如果一切顺利，你会看到屏幕上出现“Hello World”。
2.3 项目结构解析
项目跑起来了，但你可能一脸懵：这么多文件夹和文件，都是干嘛的？别急，我来给你拆解一下。
先看一张整体结构图，帮你建立全局认知：
这张图你看懂了吗？看不懂没关系，我一个个说。
2.3.1 entry 模块
这是你的应用主模块。说白了，你的代码主要写在这里面。
- src/main/java：放你的Java/ArkTS代码。注意，鸿蒙现在主推ArkTS，但Java也还能用。
- src/main/resources：资源文件夹。里面又分：
- base：默认资源，比如字符串、颜色、图片。
- en_US：英文资源。
- zh_CN：中文资源。
- src/main/module.json5：模块配置文件。这里面声明了你的Ability、权限、设备类型等。我刚开始学的时候，经常忘了在这里配权限，结果运行时崩溃，找了半天才发现。
- build.gradle：模块级构建脚本。依赖、插件都在这里配。
- oh-package.json5：包管理文件。类似npm的package.json。
2.3.2 oh_modules
这个目录存放你项目依赖的第三方库和SDK。一般不用手动管它，DevEco Studio会自动下载和管理。
但有一点要注意：如果你从网上下载了一个项目，打开后oh_modules是空的，别慌。点一下“File → Sync Project with Gradle Files”，它就会自动下载了。
2.3.3 build
编译输出目录。你打包生成的HAP文件就在这里。路径一般是：
entry/build/outputs/default/entry-default-signed.hap这个HAP文件，就是你要安装到手机上的安装包。嗯，记住这个路径，后面调试会用到。
2.3.4 其他重要文件
| 文件/目录 | 作用 |
|---|---|
| build.gradle (根目录) | 项目级构建脚本，配置全局插件和仓库 |
| settings.gradle | 声明项目包含哪些模块 |
| local.properties | 本地SDK路径配置，一般自动生成 |
| .gitignore | Git忽略规则，build目录和oh_modules建议忽略 |
好了，环境搭建和项目结构就讲到这里。你现在应该能自己创建一个项目，并且知道每个文件夹是干嘛的了。接下来，咱们就要真正开始写代码了。