❓ 提示「hdc 不是内部或外部命令」

← 返回问题清单
症状:终端里执行 hdc 报错:'hdc' 不是内部或外部命令 / command not found。
1

确认 hdc.exe 的实际位置

hdc 随 SDK 分发,常见位置:

  • …\DevEco Studio\sdk\default\openharmony\toolchains\hdc.exe
  • Command Line Tools:…\command-line-tools\sdk\default\openharmony\toolchains

在资源管理器中确认这个文件真实存在。

  • DevEco Studio:/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/
  • Command Line Tools:~/command-line-tools/sdk/default/openharmony/toolchains/

同 macOS 布局,确认 toolchains 目录下有名为 hdc 的可执行文件。

2

把 toolchains 加入 PATH

Win+R → sysdm.cpl → 高级 → 环境变量 → 用户变量的 Path → 编辑 → 新建 → 粘贴 toolchains 目录 → 确定。然后关闭所有终端窗口重新打开(旧窗口不会读到新 Path)。

写入 shell 配置:

$ echo 'export PATH="$PATH:/path/to/toolchains"' >> ~/.zshrc
$ source ~/.zshrc

写入 bashrc:

$ echo 'export PATH="$PATH:/path/to/toolchains"' >> ~/.bashrc
$ source ~/.bashrc
3

验证 hdc 可用

$ hdc list targets
(输出 [Empty] 也算命令本身可用,说明只是没设备)

不再报「不是内部或外部命令」即环境 OK。输出 [Empty] 属于连接问题,转「hdc 显示 [Empty]」。

其他问题快速跳转