原生鸿蒙（HarmonyOS 5+）从插线到 hdc 识别的完整流程
STEP 4 / 7
电脑端准备 hdc 工具（DevEco Studio / 命令行工具）
hdc 不是系统自带命令，需要从 SDK 获得，两种途径任选其一：
- 装了 DevEco Studio：hdc 在
…\DevEco Studio\sdk\default\openharmony\toolchains\hdc.exe； - 没装 IDE：到华为开发者官网下载「Command Line Tools」，解压后同样取
…\sdk\default\openharmony\toolchains； - 把该目录加入环境变量 Path：设置 → 系统 → 高级系统设置 → 环境变量 → 编辑 Path → 新建 → 粘贴目录 → 确定，重开终端生效。
- 从 DevEco Studio 或 Command Line Tools 中取得 toolchains 目录（内含 hdc 可执行文件）；
- 将其加入 PATH：
echo 'export PATH=$PATH:/path/to/toolchains' >> ~/.zshrc后source ~/.zshrc； - 首次运行如提示「无法验证开发者」，到系统设置 → 隐私与安全性 → 仍要打开。
- 取 toolchains 目录并加入 PATH（写入
~/.bashrc或~/.profile）； - 给 hdc 加执行权限：
chmod +x hdc； - 非 root 用户需配置 udev 权限（见右侧或问题排查），否则会看不到设备。
💡 hdc 服务端默认使用 8710 端口（环境变量
OHOS_HDC_SERVER_PORT 可改）。若同时开着 DevEco Studio / DevEco Testing 等自带 hdc 的工具出现端口占用报错，见问题排查「端口被占用」。✓本步完成标志：新开一个终端，输入 <code class='inline-code'>hdc</code> 或 <code class='inline-code'>hdc list targets</code> 不再提示「不是内部或外部命令」。