macOS 配置 HarmonyOS / OpenHarmony SDK 环境变量（DevEco Studio）

本文用于在 macOS 上配置 HarmonyOS / OpenHarmony 开发环境，使 hdc（HarmonyOS Device Connector）命令可以在终端全局使用。

---

一、打开 zsh 配置文件

在终端执行：

vim ~/.zshrc

---

二、进入插入模式

在 vim 中按：

i

进入编辑模式。

---

三、添加环境变量配置

将以下内容添加到文件末尾：

# ================================
# HarmonyOS / OpenHarmony SDK 配置
# ================================

# 设置 HarmonyOS SDK
export DEVECO_SDK_HOME=/Applications/DevEco-Studio.app/Contents/sdk

# 设置 HDC_SDK_PATH
export HDC_SDK_PATH=$DEVECO_SDK_HOME/default/openharmony/toolchains/

# 添加到 PATH
export PATH=$HDC_SDK_PATH:$PATH

# 设置 HDC_SERVER_PORT
export HDC_SERVER_PORT=7035

---

四、保存并退出 vim

按顺序执行：

ESC
:wq!

---

五、使配置立即生效

执行：

source ~/.zshrc

---

六、基础验证（必须）

1️⃣ 检查环境变量是否生效

echo $HDC_SDK_PATH   # 输出 hdc 工具路径
echo $DEVECO_SDK_HOME # 输出 SDK 根目录
echo $HDC_SERVER_PORT # 输出端口号

---

2️⃣ 检查 hdc 是否可用

which hdc   # 查看 hdc 是否在 PATH 中

👉 正常应输出类似：

/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc

---

3️⃣ 查看 hdc 版本（关键验证）

hdc -v

或：

hdc version

👉 正常会输出：

• hdc 版本号
• SDK build 信息
• OpenHarmony 兼容版本

---

4️⃣ 验证 SDK 目录是否完整

ls $DEVECO_SDK_HOME   # 查看 SDK 根目录结构

常见输出目录包括：

ets/
js/
native/
toolchains/
build-tools/

---

5️⃣ 验证 toolchains 工具是否存在

ls $HDC_SDK_PATH   # 查看 hdc 工具目录

应包含：

hdc
hdc_std
libhdc.dylib（或相关动态库）

---

6️⃣ 验证 hdc 服务连接（可选但推荐）

hdc start -r

或：

hdc list targets

如果设备连接正常，会返回：

<device-id> device

---

七、完整验证总结（推荐执行顺序）

你可以按以下顺序一键检查：

echo $HDC_SDK_PATH
echo $DEVECO_SDK_HOME
which hdc
hdc -v
ls $DEVECO_SDK_HOME
ls $HDC_SDK_PATH
hdc list targets

---

八、常见问题排查

❗ hdc command not found

原因：

• PATH 没生效
• DevEco 安装路径不对

解决：

source ~/.zshrc

---

❗ hdc 无法连接设备

检查：

hdc start -r

---

❗ SDK 目录为空

确认 DevEco 是否完整安装：

路径：

/Applications/DevEco-Studio.app/Contents/sdk/

---

🎯 总结

完成以上步骤后，你的 macOS 环境将具备：

• ✔ 全局 hdc 命令
• ✔ HarmonyOS SDK 环境变量
• ✔ 可连接设备调试能力
• ✔ DevEco 工具链完整访问