适用对象刚装好鸿蒙开发环境、第一次用 hdc 的新人文档定位照着一步步配就能通 随时查的命令速查 踩坑记录配套文档wukong 测试指令详解hdc 配好才能跑 wukong一、hdc 是什么30 秒理解hdcHarmonyOSDeviceConnector是鸿蒙提供的设备连接/调试命令行工具相当于 Android 的adb。通过 USB 或网络TCP连接真实设备 / 模拟器能执行shell命令、传文件、装/卸应用、抓日志wukong 测试、截图、日志分析全都建立在 hdc 能连上设备的前提上一句话记忆法hdc 鸿蒙版 adb。adb 会hdc 就会一半。二、hdc 从哪来工具获取hdc 不单独发跟着HarmonyOS SDK走放在 SDK 的toolchains目录里。两种拿到方式任选其一方式适用人群说明装 DevEco Studio大多数人IDE 自带 SDK装完直接有 hdc下载 Command Line Tools只跑命令、不写代码CI 服务器华为官网下commandline-tools压缩包解压即用默认路径速查系统hdc 所在目录示例WindowsC:\Users\你的用户名\AppData\Local\HarmonyOS\Sdk\toolchainsLinux~/HarmonyOS/Sdk/toolchains或 DevEco Studio 安装目录下的sdk/toolchainsmacOS~/Library/Huawei/sdk/toolchains或~/HarmonyOS/Sdk/toolchains找不到在 DevEco Studio 里File Settings SDK能看到 SDK 实际安装路径进去找toolchains目录即可。三、Windows 配置步骤一步一步来Step 1 找到 hdc.exe 路径按上面的路径打开文件夹确认里面有hdc.exe。Step 2 加进系统 PATH此电脑 → 右键「属性」 → 高级系统设置 → 高级 → 环境变量 → 在「系统变量」或「用户变量」里找 Path → 编辑 → 新建 → 粘贴 toolchains 目录路径如 C:\Users\xxx\AppData\Local\HarmonyOS\Sdk\toolchains → 一路确定保存Step 3 让配置生效关掉所有命令行窗口重新打开或用 DevEco Studio 的 Terminal。这一步很多人忘配完不生效多半是这个原因。Step 4 验证hdc -v能打印版本号如Ver: 1.3.0a即配置成功。⚠️Windows 驱动坑设备管理器里若HDC Device出现黄色感叹号说明驱动没装好。装华为手机助手HiSuite会自动带驱动或手动更新驱动指向HDC Device。四、Linux 配置步骤环境变量 udev 权限Linux 比 Windows 多一步USB 设备权限udev 规则否则非 root 下hdc list targets看不到设备。Step 1 找到 hdc 路径并加执行权限# 进入 toolchains 目录cd~/HarmonyOS/Sdk/toolchains# 确认有 hdc并赋予可执行权限必须chmodx hdc ./hdc-v# 能出版本号说明文件 OKStep 2 加进 PATH两种 shell 写法# Bash 用户大多数echoexport PATH$PATH:~/HarmonyOS/Sdk/toolchains~/.bashrcsource~/.bashrc# Zsh 用户macOS/部分 Linuxechoexport PATH$PATH:~/HarmonyOS/Sdk/toolchains~/.zshrcsource~/.zshrc路径换成你实际的 toolchains 绝对路径建议用绝对路径不要写~展开可能出错。Step 3 配置 udev 规则关键解决非 root 看不到设备# 1. 先插上设备看 USB 是否能识别到 HDC Devicelsusb# 输出里找类似 HDC Device / Phytium HDC Device 的行记下 Vendor ID如 12d1# 2. 新建 udev 规则文件sudovim/etc/udev/rules.d/90-hdc.rules文件内容华为设备 VID 为12d1其它厂商先用lsusb查到 VID 再替换# 让所有用户可读写 HDC 设备新手最简方案 SUBSYSTEMusb, ATTR{idVendor}12d1, MODE0666 # 若想用用户组方式更规范改为下面这行并把自己加入 plugdev 组 # SUBSYSTEMusb, ATTR{idVendor}12d1, MODE0666, GROUPplugdev# 3. 重载规则并重新触发sudoudevadm control --reload-rulessudoudevadm trigger# 4. 重新插拔 USB 线# 5. 验证无需 sudohdc list targets多渠道商设备 VID 不同记不住就lsusb看一眼把12d1换成你设备实际的 Vendor ID 即可。Step 4 验证hdc-vhdc list targets五、设备侧准备两端都要做不管 Windows 还是 Linux设备端不开调试PC 怎么配都连不上打开「设置 → 关于本机 → 连续点版本号 7 次开启开发者模式「设置 → 系统 → 开发者选项 → 开启USB 调试」用数据线连电脑在设备弹窗里点「允许 USB 调试」勾选一律允许更省事确认 USB 连接模式是「传输文件(MTP)」而非仅充电六、连接设备 验证# 查询已连接设备返回 [empty] 就是没连上hdc list targets# 打印详细信息含 connect-key多设备时用它区分hdc list targets-v# 查看客户端与服务端版本是否匹配hdc checkserver连不上的通用救法hdc kill -r杀掉异常进程并重启服务再hdc list targets。七、无线/网络调试不用 USB 线适合设备 USB 口坏了、或要做长时间稳定性测试时不想被线绊住。# 方式 A设备已在「开发者选项 → 无线调试」里开了直接连hdc tconn192.168.1.100:5555# 方式 B先通过 USB 打开设备网络通道再拔线连hdc tmode port5555# 设备端开启 TCP 监听此命令后 USB 会断hdc tconn192.168.1.100:5555# 断开网络设备或恢复 USBhdc tconn192.168.1.100:5555-removehdc tmode usb# 恢复 USB 模式网络调试要求 PC 与设备同一网段。hdc tconn的端口默认和OHOS_HDC_SERVER_PORT不是一回事别混。八、常用命令速查表配好就能干活类别命令说明版本/连接hdc -v查看 hdc 版本hdc list targets列出已连接设备hdc list targets -v列出设备详情含 connect-keyhdc checkserver校验 client/server 版本Shellhdc shell进入设备 shell前面 wukong 就在这敲hdc shell 命令单次执行如hdc shell ps -ef文件hdc file send 本地 远程本地→设备如hdc file send ./a.txt /data/local/tmp/a.txthdc file recv 远程 本地设备→本地如hdc file recv /data/local/tmp/a.txt ./a.txt应用hdc install xxx.hap安装应用-r覆盖-s替换hdc uninstall 包名卸载应用日志hdc hilog实时打印设备日志配合grep用服务hdc start -r启动/重启 hdc 服务hdc kill -r终止/重启服务连不上先试这个设备hdc target boot重启设备多设备hdc -t connect-key shell指定某台设备执行命令多设备场景一定加-t connect-key否则 hdc 不知道往哪台发命令。九、关键环境变量进阶但常用变量名作用默认值怎么用OHOS_HDC_SERVER_PORT修改 hdcserver 监听端口87108710 被占用时改掉如设18710OHOS_HDC_LOG_LEVEL调整日志打印级别排查用默认设5开详细日志Windows 设置此电脑 → 属性 → 高级 → 环境变量 → 新建系统变量。Linux/macOS 设置echoexport OHOS_HDC_SERVER_PORT18710~/.bashrcechoexport OHOS_HDC_LOG_LEVEL5~/.bashrcsource~/.bashrc⚠️ 改完环境变量要重启命令行/DevEco Studio才生效。命令行里用-s ip:port指定服务端口时会忽略这个环境变量。十、⚠️ 新手必踩的 6 个坑配完 PATH 不生效→ 八成是没重开命令行窗口。关掉重开。Linux 非 root 看不到设备→ 没配 udev 规则或没chmod x hdc。按第四节 Step 1、3 走。Windows 设备管理器 HDC Device 黄标→ 驱动没装。装 HiSuite 或手动更新驱动。设备连上但list targets是 [empty]→ 设备没开 USB 调试或弹窗没点允许或 USB 模式是仅充电。多个 hdc 版本打架→ DevEco Studio 自带一个、自己又下了一个PATH 指向混乱。确保 PATH 里只留一个 toolchains。8710 端口被占→ 设OHOS_HDC_SERVER_PORT换个端口重启命令行再试。记忆口诀连不上先hdc kill -r再看设备开没开调试再看驱动/权限。十一、标准作业流SOP# 1. 设备开开发者模式 USB 调试连电脑点允许# 2. Windows / Linux 按上面配好 PATHLinux 还要 chmod x 和 udev# 3. 验证hdc-vhdc list targets# 能看到设备序列号 成功# 4. 进 shell 跑 wukong接上一篇笔记hdc shell wukong-v十二、一句话速记卡贴显示器上hdc 鸿蒙版 adb 路径SDK 的 toolchains 目录 Windows: 加 Path → 重开终端 → hdc -v Linux: chmod x 加 Path udev(VID 12d1) 重插拔 设备: 开发者模式 USB调试 点允许 传输文件模式 hdc list targets 查设备 hdc shell 进设备 hdc tconn IP:端口 无线连 hdc kill -r 连不上先重启服务 OHOS_HDC_SERVER_PORT 默认 8710冲突就改参考来源华为开发者文档hdc 调试命令华为设备开发文档hdc - 调试命令