3. 开发环境搭建：DevEco Studio安装配置、HarmonyOS SDK下载、模拟器与真机调试环境准备
说实话，做鸿蒙开发这么多年，我见过太多人卡在环境搭建这一步。明明代码逻辑没问题，结果因为SDK版本不对、模拟器起不来，折腾一整天。今天我就把这几年的经验捋一捋，帮你把这条路铺平。
3.1 DevEco Studio 安装与配置
DevEco Studio 是华为官方推出的IDE，基于IntelliJ IDEA社区版定制。说白了，如果你用过Android Studio，上手会非常快。
3.1.1 下载与安装
去华为开发者官网下载最新版。我个人习惯用Windows版，但Mac和Linux也完全支持。安装时注意几点：
- 路径不要有中文——我遇到过有人把SDK装到「D:\开发工具」里，结果编译报错，查了半天才发现是中文路径的问题
- JDK版本：DevEco Studio 3.1及以上版本自带JDK 11，不需要额外安装。但如果你用老版本，记得配好JAVA_HOME
- 内存分配：建议至少给IDE分配4GB内存。你想想看，同时开模拟器和IDE，内存不够的话卡到你怀疑人生
3.1.2 基础配置
安装完第一件事，配置SDK路径。打开 Settings → Languages & Frameworks → HarmonyOS SDK，这里会显示SDK的安装位置。默认在用户目录下的 .HarmonyOS 文件夹里。
# 我习惯把SDK单独放一个盘，方便管理
D:\HarmonyOS\SDK
# 或者
~/HarmonyOS/SDK为什么要单独放？因为以后升级SDK、切换版本，你只需要改环境变量，不用重新下载整个IDE。这个坑我踩过——第一次用默认路径，后来想换版本，结果IDE重装了，SDK也得重新下，白白浪费半天时间。
3.2 HarmonyOS SDK 下载与管理
SDK是开发的基础。没有它，你连Hello World都跑不起来。HarmonyOS SDK 包含几个核心组件：
| 组件名称 | 说明 | 版本建议 |
|---|---|---|
| API Version | 对应鸿蒙系统的API级别 | 建议用最新稳定版 |
| Toolchains | 编译工具链，包括hvigor、cmake等 | 随SDK自动更新 |
| System Image | 模拟器系统镜像 | 按需下载，别全下 |
| Emulator | 模拟器运行环境 | 必须安装 |
3.2.1 下载SDK
在DevEco Studio里，打开 SDK Manager。你会看到一排可下载的SDK版本。嗯，这里要注意：
- 别贪多：只下载你需要的API版本。我见过有人一口气下了5个版本，结果硬盘爆了，还影响IDE启动速度
- API 9 是分水岭：API 9 开始支持ArkTS和Stage模型。如果你是新项目，直接上API 9或更高
- Previewer 也要装：这是预览器，写UI时实时看效果，比模拟器快得多
3.2.2 配置环境变量
SDK下载完，建议配一下环境变量。这样你在命令行里也能用hdc（鸿蒙设备调试工具）和hvigor（构建工具）。
# Windows 系统
set HARMONYOS_SDK_HOME=D:\HarmonyOS\SDK
set PATH=%PATH%;%HARMONYOS_SDK_HOME%\toolchains
# Mac/Linux 系统
export HARMONYOS_SDK_HOME=~/HarmonyOS/SDK
export PATH=$PATH:$HARMONYOS_SDK_HOME/toolchains配好之后，打开终端输入 hdc -v，如果能显示版本号，说明配置成功。
3.3 模拟器环境准备
模拟器是开发阶段最常用的调试工具。说实话，鸿蒙的模拟器比我想象中要好用，启动速度快，而且支持多种设备类型。
3.3.1 创建模拟器
在DevEco Studio里，点击 Tools → Device Manager，打开模拟器管理界面。点击「+」号创建新模拟器：
- 选择设备类型：手机、平板、智能手表、智慧屏……根据你的应用场景选。我一般先建一个手机模拟器，跑通基本功能
- 选择系统镜像：这里会列出你已下载的镜像。如果没有，点「Download」按钮下载
- 配置内存和存储：手机模拟器建议2GB内存起步，存储4GB够用。别给太多，否则你的电脑会哭
3.3.2 模拟器常用操作
模拟器启动后，你会看到一个完整的鸿蒙系统界面。有几个操作你一定会用到：
- 旋转屏幕：Ctrl + F11（Windows）或 Cmd + F11（Mac）
- 截屏：模拟器工具栏上的相机图标
- 发送虚拟数据：比如模拟GPS位置、来电、短信等，在模拟器扩展控制面板里
- 调整网络状态：可以模拟弱网、断网场景，测试应用的健壮性
3.4 真机调试环境准备
模拟器再方便，也替代不了真机。有些功能——比如NFC、蓝牙、传感器——只能在真机上测试。所以真机调试环境必须配好。
3.4.1 开启开发者模式
在鸿蒙手机上，进入「设置」→「关于手机」，连续点击「版本号」7次，直到提示「已进入开发者模式」。然后返回「设置」→「系统和更新」→「开发人员选项」，打开：
- USB调试：必须开启
- 仅充电模式下允许ADB调试：建议开启，省得每次都要切换USB模式
- 不锁定屏幕：调试时方便，但记得用完关掉
3.4.2 连接与调试
用USB线连接手机和电脑。在DevEco Studio的「Run」配置里，选择「Device」为「USB Connected Device」。点击运行按钮，IDE会自动安装应用并启动。
如果你用的是HarmonyOS 3.0及以上版本，还支持无线调试。在开发者选项里打开「无线调试」，然后用hdc命令连接：
# 先通过USB连接，获取设备的IP地址
hdc shell ip addr show wlan0
# 然后断开USB，用无线连接
hdc tconn 192.168.1.100:5555无线调试的好处是——不用被线束缚。我经常在工位上无线连接，然后拿着手机到处走，测试各种场景。
3.5 环境验证：跑一个Hello World
环境搭好没？跑个Hello World验证一下。创建一个新的HarmonyOS项目，选择Empty Ability模板，语言选ArkTS。然后直接运行：
// 如果能在模拟器或真机上看到 "Hello World" 字样
// 说明你的开发环境已经搭建成功如果遇到问题，别慌。先看Build Output窗口的日志，90%的问题都能从日志里找到线索。剩下的10%，嗯，去华为开发者论坛搜一下，基本都有答案。
环境搭建检查清单：
- ☐ DevEco Studio 安装完成，能正常启动
- ☐ HarmonyOS SDK 下载完成，版本匹配
- ☐ 环境变量配置正确，hdc命令可用
- ☐ 模拟器能启动，应用能安装运行
- ☐ 真机能连接，USB调试正常
环境搭建这一步，说白了就是「磨刀不误砍柴工」。花点时间把基础打牢，后面开发调试会顺畅很多。我个人习惯每换一台电脑，第一件事就是按这个流程走一遍，确保环境一致。这样团队协作时，不会出现「我这儿能跑，你那儿不行」的尴尬情况。
这张图把整个流程串起来了。从安装IDE开始，到配置SDK和环境变量，然后根据你的需求选择模拟器或真机调试，最后用Hello World验证。每一步都有坑，但只要你按这个流程走，基本不会出大问题。