HCCDA 鸿蒙实验代码调试常见问题

新手在调试鸿蒙应用实验代码时，常遇到以下典型问题：

• 开发环境配置错误导致无法编译
• 模拟器连接失败或运行异常
• 日志输出不完整难以定位问题
• 组件生命周期理解不足引发bug

环境配置检查要点

确保DevEco Studio版本与SDK匹配，检查环境变量配置：

# 检查Node.js和Ohpm版本
node -v
ohpm -v

配置华为镜像源加速依赖下载：

// ohpm.json
{
  "registry": "https://repo.harmonyos.com/ohpm/"
}

模拟器调试技巧

使用远程模拟器时，注意防火墙设置可能导致连接失败。建议：

• 关闭杀毒软件临时测试
• 使用命令行手动启动模拟器：

hdc shell am start -a ohos.samples.demo -b com.example.demo

内存不足时调整模拟器配置：

1. 打开Device Manager
2. 选择相应模拟器点击Edit
3. 将Memory Size调整为4GB以上

日志高效捕获方法

使用hilog命令过滤特定级别日志：

hilog -T "MyTag" -D

添加自定义日志标签：

import hilog from '@ohos.hilog';
hilog.info(0x0000, 'MyTag', '%{public}s', 'Debug message');

多设备连接时指定设备ID：

hdc -t [device_id] shell hilog

组件生命周期调试

在EntryAbility.ts中添加生命周期回调监控：

onWindowStageCreate(windowStage: window.WindowStage) {
  hilog.info(0x0000, 'Lifecycle', 'WindowStage created');
  windowStage.loadContent('pages/Index', (err) => {
    if (err) {
      hilog.error(0x0000, 'LoadContent', 'Failed: %{public}s', err.message);
    }
  });
}

使用断点调试时，注意异步回调函数的执行上下文。在config.json中开启调试模式：

{
  "abilities": [
    {
      "debugEnabled": true
    }
  ]
}

性能问题排查

通过hdc命令获取性能数据：

hdc shell param dump

监控内存泄漏：

hdc shell top -n 1

分析UI刷新性能：

// 在自定义组件中添加渲染耗时统计
aboutToAppear() {
  const startTime = new Date().getTime();
  // ...
  const endTime = new Date().getTime();
  hilog.info(0x0000, 'Performance', 'Render cost: %{public}dms', endTime - startTime);
}