MAC 配置鸿蒙(HarmonyOS) SDK 环境变量完整指南

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

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

一、打开 zsh 配置文件

在终端执行：

bash 复制代码

vim ~/.zshrc

二、进入插入模式

在 vim 中按：

复制代码

进入编辑模式。

三、添加环境变量配置

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

bash 复制代码

# ================================
# 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!

五、使配置立即生效

执行：

bash 复制代码

source ~/.zshrc

六、基础验证（必须）

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

bash 复制代码

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

2️⃣ 检查 hdc 是否可用

bash 复制代码

which hdc   # 查看 hdc 是否在 PATH 中

👉 正常应输出类似：

复制代码

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

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

bash 复制代码

hdc -v

或：

bash 复制代码

hdc version

👉 正常会输出：

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

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

bash 复制代码

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

常见输出目录包括：

复制代码

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

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

bash 复制代码

ls $HDC_SDK_PATH   # 查看 hdc 工具目录

应包含：

复制代码

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

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

bash 复制代码

hdc start -r

或：

bash 复制代码

hdc list targets

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

复制代码

<device-id> device

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

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

bash 复制代码

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 安装路径不对

解决：

bash 复制代码

source ~/.zshrc

❗ hdc 无法连接设备

检查：

bash 复制代码

hdc start -r

❗ SDK 目录为空

确认 DevEco 是否完整安装：

路径：

复制代码

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

🎯 总结

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

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