在Mac上配置和使用HDC工具的指南

发表于 2026-10-4 14:39:43

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要登录才可以下载或查看，没有账号？立即注册

×

hdc 是 HarmonyOS 设备连接与调试的命令行工具，就在 DevEco Studio 的 SDK toolchains 目录下。按它跑不起来多半是环境变量没生效——尤其是 Mac 上进程间取不到新开终端设的变量，需要走 launchctl。

一、找到 hdc 工具

hdc 工具随 HarmonyOS SDK 一起装，位置在 SDK 的 toolchains 目录（例如 /Users/<用户名>/HM/sdk/openharmony/10/toolchains）。在 DevEco 的 Preferences → SDK 里能看到路径，toolchains 没装就先补上。

二、配端口变量 HDC_SERVER_PORT

先确认自己用的是哪个 shell：

echo $SHELL

输出 /bin/bash 就编辑 ~/.bash_profile，输出 /bin/zsh 就编辑 ~/.zshrc。在插入模式下加三行：

HDC_SERVER_PORT=7035
launchctl setenv HDC_SERVER_PORT $HDC_SERVER_PORT
export HDC_SERVER_PORT

保存退出：先按 Esc 回命令模式，再输入 :wq 回车。然后让它生效——bash 用户 source ~/.bash_profile，zsh 用户 source ~/.zshrc。

三、把 SDK 路径加进 PATH

同一个配置文件里再补：

HDC_SDK_PATH=/Users/<用户名>/HM/sdk/openharmony/10/toolchains
launchctl setenv HDC_SDK_PATH $HDC_SDK_PATH
export PATH=$PATHHDC_SDK_PATH

同样保存并 source 一次。

四、验证

hdc --version

能打印出 Ver: 1.3.0a 之类的版本号，就说明任意目录下都能用 hdc 命令了。

五、连不上设备时的两个急救命令

服务卡住：hdc kill -r 杀掉异常进程并重启 hdc 服务。
hdc list targets 拿不到设备：先查有没有 hdc 进程残留，再重启 hdc 服务。

Mac 与 Windows 最大的区别在于：新开的终端不会继承 export 给系统进程的值，所以配完必须额外 launchctl setenv，否则 IDE 里点了调试、命令行里 hdc 却找不到设备，就会两头对不上。

qidao123.com企服评测-应用市场编辑提示