harmonyOS常用hdc命令

一、hdc 是什么？

• 定位：鸿蒙设备的调试工具（类似 Android 的 adb）
• 核心功能：
  • 设备连接管理
  • 应用安装/卸载
  • 日志抓取
  • 分布式调试
• 与Web调试对比：

  flowchart LR
      Web调试-->Chrome_DevTools
     鸿蒙调试-->hdc+DevEco_Profiler
  

---

二、设备管理命令

命令	说明	Web开发类比
hdc list targets	查看已连接设备	Chrome的chrome://inspect
hdc target mount	挂载设备存储	无直接对应
hdc shell	进入设备Shell	浏览器Console

---

三、应用管理命令

命令	示例	场景
安装应用	hdc install -r example.hap	类似npm install但需指定路径
卸载应用	hdc uninstall com.example.app	对应Web的localStorage.clear()
启动应用	hdc shell aa start -a EntryAbility	类似浏览器打开特定URL

特殊参数：

• -r：覆盖安装（热更新）
• -p：指定安装路径（鸿蒙无沙箱限制）

---

四、日志管理命令

命令	说明	前端对标工具
hdc hilog	查看系统日志	console.log
hdc hilog -g	清除日志	Chrome日志清空
hdc hilog -t 5	抓取最近5秒日志	performance.now()

高级用法：

# 过滤特定标签日志（类似前端console过滤）
hdc hilog -T "Distributed"  

# 追踪跨设备调用（鸿蒙特有）
hdc hilog -t DeviceA→DeviceB

---

五、文件操作命令

命令	示例	说明
推送文件	hdc file send ./local.txt /data/remote.txt	类似scp
拉取文件	hdc file recv /data/app.log ./	下载日志分析
设备截图	hdc shell snapshot_display -f /sdcard/screen.png	类似浏览器截图API

---

六、性能调试命令

命令	说明	前端对标
hdc shell top	查看进程资源占用	Chrome Task Manager
hdc shell meminfo	内存详情	performance.memory
hdc shell dumpsys gfx	渲染性能分析	Chrome Rendering面板

---

七、Web开发者特别注意

1. 线程调试差异：

   # 查看UI线程状态（鸿蒙严格区分线程）
   hdc shell ps | grep uithread
   

   • Web开发通常单线程，鸿蒙需关注多线程协同

2. 分布式调试技巧：

   # 追踪跨设备方法调用
   hdc hilog -t "DistributedTrace"
   

3. 快速定位ANR：

   hdc shell cat /data/anr/traces.txt
   

---

八、常用命令组合示例

# 1. 安装应用并立即启动
hdc install -r app.hap && hdc shell aa start -a EntryAbility

# 2. 抓取崩溃日志
hdc hilog -T "CRASH" > crash.log

# 3. 性能问题排查三板斧
hdc shell top -n 1
hdc shell meminfo com.example.app
hdc hilog -t "Performance"

---

九、与前端调试的对比总结

调试维度	Web方案	鸿蒙方案
日志查看	Chrome Console	hdc hilog
性能分析	Lighthouse	hdc shell dumpsys gfx
跨设备调试	无原生方案	hdc -t DeviceA→DeviceB
热更新	Vite HMR	hdc install -r