第二章：开发环境搭建与工具链

说实话，我见过太多开发者卡在环境搭建这一步。明明代码逻辑没问题，就是跑不起来。最后发现，要么是SDK版本不对，要么是模拟器没配好。这一章，我就带你把这些坑一个个填平。

2.1 DevEco Studio 安装与配置

DevEco Studio 是鸿蒙开发的官方IDE，基于IntelliJ IDEA定制。我个人习惯用它的原因是——开箱即用，省去了很多手动配置的麻烦。

2.1.1 下载与安装

去官网下载对应操作系统的安装包。Windows用户注意，安装路径不要带中文和空格。我曾经有个同事，把路径写成了「D:\鸿蒙开发\工具」，结果编译时各种报错。嗯，这种问题排查起来真的很浪费时间。

2.1.2 首次启动配置

安装完成后，第一次启动会引导你配置几个关键项：

• Node.js路径：DevEco Studio依赖Node.js做前端构建。如果你电脑里没有，它会自动帮你下载一个。
• Ohpm路径：鸿蒙的包管理器，类似npm。我建议用默认路径，别乱改。
• SDK路径：这个稍后细说。

配置完成后，你会看到一个欢迎界面。别急着点「新建项目」，先检查一下SDK管理。

2.2 鸿蒙SDK管理

SDK管理，说白了就是管理你电脑上装了哪些版本的鸿蒙API。为什么重要？因为不同版本的API可能有差异，你写的代码在API 9上能跑，换到API 10可能就报错了。

2.2.1 打开SDK管理器

在DevEco Studio的菜单栏找到：Tools → SDK Manager。你会看到这样的界面：

SDK Manager
├── HarmonyOS SDK
│   ├── API Version 9 (推荐)
│   ├── API Version 10
│   └── API Version 11 (最新)
├── OpenHarmony SDK
│   └── API Version 9
└── SDK Tools
    ├── hdc
    ├── hvigor
    └── ohpm

2.2.2 选择SDK版本

我个人建议：

• 初学者：装API 9和API 10就够了。API 9最稳定，API 10新增了分布式能力。
• 进阶开发者：可以装API 11，体验一下新特性。但注意，有些API可能还没完全稳定。

2.2.3 常见问题

「为什么我下载SDK总是失败？」——这个问题我被问过很多次。原因通常是网络问题。鸿蒙SDK的下载源在国外，你可以试试配置镜像源：

// 在 ~/.ohpmrc 文件中添加
registry=https://repo.harmonyos.com/ohpm/

如果还是不行，那就挂个代理吧。我当年为了下SDK，折腾了整整一个下午。后来发现，其实就是防火墙拦住了。

2.3 模拟器与真机调试

调试，是开发中最频繁的操作。你写一行代码，就得跑一次看看效果。所以，调试环境必须顺手。

2.3.1 模拟器配置

DevEco Studio内置了模拟器管理器。打开方式：Tools → Device Manager。

创建模拟器的步骤：

1. 点击「+」新建模拟器
2. 选择设备类型（手机、平板、手表等）
3. 选择系统版本（建议和你的SDK版本一致）
4. 分配内存和存储空间

我记得第一次用模拟器时，发现它启动特别慢。后来才明白，是因为我分配的内存太少。你想想看，模拟器本身就要跑一个完整的操作系统，你只给2GB内存，它当然卡。

2.3.2 真机调试

模拟器再方便，也比不上真机。真机调试能发现很多模拟器上发现不了的问题，比如性能、触摸响应、传感器数据等。

连接真机的步骤：

1. 打开手机的「开发者模式」：设置 → 关于手机 → 连续点击版本号7次
2. 开启「USB调试」
3. 用USB线连接电脑
4. 在DevEco Studio中选择你的设备

2.3.3 调试技巧

调试时，我习惯用这几个功能：

• 断点调试：在代码行号旁边点一下，就能设置断点。运行到断点处，程序会暂停，你可以查看变量值。
• Log输出：用 HiLog.info() 打印日志。我个人喜欢在关键路径上打日志，方便追踪问题。
• Profiler：性能分析工具。如果发现页面卡顿，用Profiler看看是CPU占用高还是内存泄漏。

2.4 命令行工具 hdc 使用

hdc，全称是 HarmonyOS Device Connector。说白了，就是鸿蒙版的adb。如果你做过Android开发，对adb应该不陌生。hdc的用法和adb非常相似。

2.4.1 安装与验证

hdc通常随SDK一起安装。你可以在SDK目录下找到它：

# Windows
%USERPROFILE%\AppData\Local\Huawei\Sdk\openharmony\9\toolchains\hdc.exe

# macOS/Linux
~/Library/Huawei/Sdk/openharmony/9/toolchains/hdc

验证是否安装成功：

hdc version
# 输出类似：HDC version: 1.2.0

2.4.2 常用命令

我整理了一份常用命令表，建议你收藏：

命令	说明	示例
hdc list targets	列出所有连接的设备	查看设备是否识别
hdc shell	进入设备shell	在设备上执行命令
hdc install	安装应用	hdc install app.hap
hdc uninstall	卸载应用	hdc uninstall com.example.app
hdc file send	发送文件到设备	hdc file send local.txt /data/
hdc file recv	从设备接收文件	hdc file recv /data/log.txt ./

2.4.3 实战场景

举个例子。有一次，我需要在真机上查看应用的日志。用DevEco Studio的Log窗口当然可以，但有时候日志太多，筛选起来很麻烦。这时候，hdc就派上用场了：

# 查看所有日志
hdc shell hilog

# 按标签筛选
hdc shell hilog -T MyApp

# 保存到本地文件
hdc shell hilog -T MyApp > app_log.txt

你想想看，用命令行筛选日志，是不是比在IDE里翻来翻去快多了？

2.4.4 避坑指南

我曾经遇到过一个问题：hdc连接不上设备。排查了半天，发现是USB线的问题。有些USB线只能充电，不能传数据。所以，如果你连不上设备，先换根线试试。

另外，hdc的端口是默认的，如果你电脑上装了其他占用端口的软件（比如某些虚拟机），可能会冲突。这时候可以手动指定端口：

hdc -t 127.0.0.1:5555 shell

知识体系总览

为了让你更直观地理解本章的知识结构，我画了一张图：

这张图把本章的内容串起来了。你看，从DevEco Studio这个IDE出发，延伸到SDK管理、调试工具和命令行工具。这四个部分缺一不可。