鸿蒙PC 报错排查与性能治理实战:用 ArkUI 跨平台框架做「勘误」归因台,把 134 次异常收敛成可验收的工单闭环

欢迎加入开源鸿蒙PC社区: https://harmonypc.csdn.net/

欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper


前言:报错排查这件事,在手机端和鸿蒙PC 端是两种工作量。手机上一条崩溃的生命周期通常只有几十秒:用户点开、闪退、重进,你可能永远拿不到复现;而鸿蒙PC 的 2in1 桌面形态完全不同——同一个用户会在一个窗口里连续工作八小时,窗口可以随手拉到任意宽度,鼠标每秒扫过几十次控件,后台的序列化、缩略图解码、网络重传和前台渲染同时跑。结果是同一条空指针在手机上算"偶发",在鸿蒙PC 上会变成一条持续上扬的曲线,第二天用户开机还会再撞一次。所以桌面端需要的不是一个"看日志的页面",而是一条能交班的流水线:谁先看、看什么、什么时候算修好、修好凭什么放行。

本文配套工程是一套真实的鸿蒙PC 工程:应用「勘误 · Errtrace」,纯 ArkTS + ArkUI 声明式 UI,deviceTypes 只保留 ['2in1'],SDK 26.0.0,零三方依赖,15 个手写 .ets 文件(其中 4 个是没人引用的孤儿组件,第六章会点名)。它把一次报错处理拆成四个互斥工作面——异常总览 → 堆栈归因 → 复现路径 → 修复工单——并用「次数排序 → 疑似帧标注 → 双设备清单门禁 → 状态机归档」这条链,把"我看过了"变成"我签名了"。文章沿三条线推进:报错排查(四步交接里每一步交接什么、漏什么)、性能优化(鸿蒙PC 窗口拉伸导致的 Canvas 重绘风暴、build() 里的 8 次遍历、ForEach 的 key 抖动等四处真实热点)、方案选型治理(为什么这个台面用 ArkUI 原生而不是再套一层跨平台框架,什么条件下应该反过来选)。

需要提前把话说清楚:本工程使用的是 ArkUI,不是 ArkUI-X,工程里没有引入任何跨平台框架运行时,也没有 Android / iOS 产物;文中提到的 ArkUI-X、Flutter、Compose Multiplatform 只作为"要不要换框架"的选型对照出现。界面上的 134 次、37 次、54 次、4 张工单全部是 common/Models.ets 里的本地演示常量,工程不采集真实崩溃(页脚已写明"本地演示数据 · 不采集真实崩溃")。凡是能静态数出来的数字,我给文件与行号;凡是估算,我说明估算依据;凡是"设计上应该有、代码里其实没有"的地方,我会直接指出并给补丁,不把演示原型包装成生产工具。

关键词:鸿蒙PC、鸿蒙 PC、开源鸿蒙PC、ArkUI、ArkUI 跨平台框架、跨平台框架选型、报错排查、堆栈归因、符号化、复现清单门禁、修复工单状态机、性能优化、Canvas 重绘、ForEach key 抖动、派生统计、口径治理、AtomGit。


鸿蒙PC 真机完整桌面:DevEco Studio 工程 Adjudra_ohos 与本应用窗口叠放,应用停在「异常总览」,可见七日趋势折线、类别分布条与异常榜单

开篇图 鸿蒙PC 真机完整桌面(不是手机截图、不是应用内裁剪图):底部是系统 Dock 与「搜索」,右下角是网络 / 音量 / 电池托盘与时间,前台是应用窗口,标题栏三个系统按钮齐全。窗口内顶栏是品牌区「勘误 / ERRTRACE / CRASH & ERROR TRIAGE CONSOLE」与四个页签「异常总览 / 堆栈归因 / 复现路径 / 修复工单」,右上角写着「3 类高频异常 · 3 张进行中工单」和「+ 新建工单」;主区 01 号块是七日趋势折线,02 号块是类别分布(Native 崩溃 45 次、ANR 无响应 12 次、JS 异常 54 次、网络错误 23 次),03 号块是异常榜单,其中「ndk 图像解码空指针 SIGSEGV」一条被选中高亮;背景里的 DevEco Studio 露出「项目结构 / Project/Product / 签名配置 / 编译选项」面板与工程树 build-profile.json5、hvigorfile.ts、oh-package.json5、entry,证明这不是一张 UI 概念稿

这张图值得停三秒,因为它一次暴露了本文要处理的三个问题:

其一,同一个屏幕上出现了两个"总计"。榜单口径的合计是 37 + 54 + 23 + 12 + 8 = 134 次,而七日趋势折线背后是另一份常量数组,七天加起来只有 64 次。两个数字都是"总异常次数",却互不相等——这不是笔误,而是"图和表各写一份数据"的典型后果,第四章会用代码把这份账算平。

其二,四个页签是四个工作面,不是四个模块。它们共享同一份 @State(选中异常、复现清单、工单列表),切换页签只改 Index.ets 里的一个字符串,不重新取数、不重建页面。这个设计扛住了"来回切页"的苛求,但也带来一个隐患:所有派生统计都挤在渲染路径里现算,页面越重、算得越多。

其三,窗口宽度是变量。手机应用只需要处理"竖屏 / 横屏"两档,鸿蒙PC 上一个窗口从 800 拉到 1600 像素是日常操作。OverviewView 的折线是画在 Canvas 上的,宽度一变就得整块重画——这是本文性能部分的第一个热点,也是桌面形态才有的问题。

一、四张真机截图与工程基线:先把"界面"和"代码"对上

技术文章最容易失信的地方,是把"我截到的界面"当成"我测到的数据"。所以先把可核对的事实钉成一张表,后面每一条论断都挂在这张表上。

表 1 工程基线(每一项都能在源码里查到,不是估值)

项实际值证据
应用名 / 英文名「勘误 · Errtrace」/ ERRTRACEAppScope/resources/base/element/string.json、common/Theme.ets:26-28
包名com.adjudra.choiceboardAppScope/app.json5:3
版本versionCode 1000000、versionName 1.0.0AppScope/app.json5:5-6
设备形态仅 ['2in1'],无 phone / tabletentry/src/main/module.json5:7
SDKcompatibleSdkVersion / targetSdkVersion 均 26.0.0build-profile.json5:21-22
构建模型hvigor + ohpm,Stage 模型,strictMode.useNormalizedOHMUrl: truebuild-profile.json5:26
三方依赖工程级、模块级 dependencies 均为 {}oh-package.json5:9
页面入口windowStage.loadContent('pages/Index'),单页应用EntryAbility.ets:12、main_pages.json
源码规模15 个手写 .ets,合计 2505 行;被引用 11 个共 1597 行entry/src/main/ets/ 逐文件统计
状态中心pages/Index.ets 237 行,12 个 @State,四视图互斥分支pages/Index.ets:17-28
数据层Models.ets 184 行,5 条异常 / 5 帧调用链 / 5 步复现 / 4 张工单 / 7 日趋势常量common/Models.ets:143-184
主题17 色硬编码色板 + 顶栏高 62common/Theme.ets:1-22

这张表说明两件事。第一,这是一个零三方依赖的鸿蒙PC 原生 2in1 工程:进程起来直接加载单页,没有框架运行时抢主线程,所以任何卡顿都更容易归因到业务代码本身;代价是聚合、统计、落盘、符号化全部得自己写。第二,桌面形态适配只做了一半:deviceTypes 钉死 2in1 是对的,但窗口宽度断点、键盘焦点、列表虚拟化三项都没做(onKeyEvent、focusable、List / LazyForEach / Repeat 在全工程零出现,可自行 Ctrl+F 验证)。

表 2 屏幕上的数字从哪来(这决定它可不可信)

界面数字值来源可信度
近 7 日总计134 次seedErrors() 五条 count 之和 37+54+23+12+8真派生,但选择了错误的基数(见第四章)
七日趋势折线合计 64 次dailyCounts() 常量 [6,9,4,12,7,15,11]假派生:与榜单无任何计算关系
类别分布四行45 / 12 / 54 / 23对 errors 按 category 过滤后累加,build() 内实时算真派生,但每帧重算 8 次遍历
异常榜单排序e3 54 → e1 37 → e4 23 → e2 12 → e5 8hotErrors() 每次渲染 slice + sort真派生,每次 build() 重排
3 类高频异常3count >= 20 计数:e1 / e3 / e4真派生,阈值写死在顶栏
3 张进行中工单3状态 ≠ verified 的工单:t1 / t2 / t4真派生
疑似帧 22StackView.ets:164 里硬编码的字符串 '2'硬编码,与 seedFrames() 中 suspect 数量没有计算关系
复现通过率 100%100done / steps.length * 100,5/5真派生
MateBook · 16GB—Index.ets:24 的 deviceTag,点击在两档之间轮换真实交互,但不参与任何计算

这张表里有两行值得单独记一下:"趋势 64"是假派生,"疑似帧 2"是硬编码。它们不影响界面好看,却直接决定这个台面能不能被信任——排查工具最怕的不是算得慢,是算得"看起来对"。第四章和第六章分别把这两笔账补上。

二、报错排查:四次交接,和两处只写在文案里的门禁

四个工作面之间的关系不是"四个功能",而是一条交班链:每往下一步,都要交出一样东西(证据),并接收一条约束(门禁)。下图是我按 Index.ets 的实际分支画的,不美化。

鸿蒙PC「勘误」报错排查闭环:异常总览 → 堆栈归因 → 复现路径 → 修复工单,下方一道验收门禁

图 1 四个工作面共用一份状态:视图切换只改 Index.ets 的 @State view,数据不重取、页面不重建。橙色块是"次数排序"、蓝色块是"符号化归因"、绿色块是"清单门禁"、红色块是"状态机归档",颜色与工程里 ChoiceColors 的语义色一致

2.1 异常总览:先把"哪一条最贵"算出来

总览页只做三件事:按次数排序、按类别分桶、给一条"开单"入口。排序逻辑在 OverviewView.ets:78-82:

private hotErrors(): ErrorEvent[] {
  const copy: ErrorEvent[] = this.errors.slice();
  copy.sort((a: ErrorEvent, b: ErrorEvent) => b.count - a.count);
  return copy;
}

这里有两个值得肯定的细节。一是 slice() 先复制再排序:ArkUI 的 @Prop 数组并不保证你把排序结果写回去不会污染上层状态,先复制是防"排序污染源数组"的最小成本。二是排序键用的是"次数"而不是"最近发生时间":对一个每天只处理 30 分钟的排查者来说,"哪条最贵"比"哪条最新"更重要,最新只在详情里看。

但也要承认,这套排序在鸿蒙PC 上会失真:桌面会话长、同一条异常会在同一台设备上被反复触发,count 自然向"用得久的机器"倾斜。真接日志之后应该改成"次数 × 影响用户数",或者干脆用 hiAppEvent 的事件维度和 FaultLogger 的故障维度分开统计——这部分我在第五章的"落地路径"里给了一个可执行的拆法。

2.2 堆栈归因:符号化开关与"疑似帧"

第二个工作面是整篇文章里最"像排查工具"的一块:左侧异常列表,右侧从 #0 往下的调用链,橙色高亮标出疑似归因点,底部一条归因结论。

鸿蒙PC 真机完整桌面:堆栈归因页,左侧 5 条异常可切换,右侧 #0~#4 五帧调用链,前两帧标「疑似归因」,底部红色归因结论条

图 2 鸿蒙PC 真机完整桌面:窗口停在「堆栈归因」。左栏是异常切换(ndk 图像解码空指针 SIGSEGV / 主线程序列化超时触发 ANR / 列表项 undefined 读取 TypeError / 上报接口 502 未重试 / 大图 Bitmap OOM),右栏从 #0 ImageDecoder::DecodeToPixelMap(modules/media/image_decoder.cpp:214)到 #4 Runtime::StartAbility,前两帧橙色「疑似归因」,底部归因结论写"解码前未校验已释放的像素句柄,批量导入 + 页面切换时句柄被异步回收导致空指针";右上角是「符号化 已开启」

这一页的技术点不在 UI,在帧的字段设计。Models.ets:36-50 把一帧拆成五个字段:

export class StackFrame {
  index: number;      // 帧序号,0 是最内层
  symbol: string;     // 符号名,符号化后才有
  file: string;       // 源文件(Native 帧是 .cpp,ArkTS 帧是 .ets)
  line: number;       // 行号,符号化后才有
  suspect: boolean;   // 是否标为疑似归因点
  constructor(index: number, symbol: string, file: string, line: number, suspect: boolean) {
    this.index = index;
    this.symbol = symbol;
    this.file = file;
    this.line = line;
    this.suspect = suspect;
  }
}

symbol + line 两个字段是"符号化"这个开关的落点:StackView.ets:97 用一行三元表达式决定显示 file:line 还是 file (未符号化)。这个设计很省事,但要注意它的语义边界——真实的符号化不是 UI 开关,是一次带符号表的重解析。Release 包里 libentry.so 的 crash 地址是裸偏移,要靠 so 的 .symtab 或打包时导出的符号文件(build/default/intermediates/libs/.../*.so 与 unstripped 目录)离线还原。所以"符号化开关"在产品里应该是"取符号化结果 / 取原始偏移"两种数据源,而不是同一份数据换个渲染方式——这一点是原型与真工具最大的差距,也是本文必须写明的一条边界。

2.3 复现路径:把"我也复现了"变成可以计数的事

排查会上最没信息量的一句话是"我这边也复现了"。第三个工作面就是把它变成可计数的事:一份最小复现清单,逐步勾选,实时折算通过率。

鸿蒙PC 真机完整桌面:复现路径页,右侧 01 步骤清单 5 步全部绿色勾选、5/5 已验证,中间 02 验证进度显示复现通过率 100%,下方采样提示

图 3 鸿蒙PC 真机完整桌面:窗口停在「复现路径」。左栏 01 步骤清单五步(清空数据冷启动 / 相册选 30 张以上批量导入 / 导入期间快速切设置页 / 关闭批量导入改逐张 / 低内存 4GB 重复)全部标「已复现」;右栏 02 验证进度「复现通过率 100%」加一条绿色进度条,下面是"验收约定:修复工单转「已验证」前,必须在两台不同内存档位的设备上走完本清单,且通过率不低于 80%",再下面是蓝色「采样提示」卡;顶部右侧是「MateBook · 16GB」设备档位按钮与「重置勾选」

通过率的算法只有两行(Index.ets:165-166):

this.passRate = Math.round(this.steps.filter((step: ReproStep) => step.done).length /
  Math.max(1, this.steps.length) * 100);

Math.max(1, ...) 这个写法是对的:清单被清空时不至于除零,而是老老实实算出 0%。这种"防御式分母"是小函数里最容易漏、又最容易在线上炸的一行,值得抄。

截图里 5/5 全部勾选、通过率 100%,这是演示数据被全部点满的状态;代码里更值得注意的是勾选状态的容器更新方式(Index.ets:158-167):

onToggleStep: (id: string) => {
  const next: ReproStep[] = [];
  this.steps.forEach((step: ReproStep) => {
    next.push(new ReproStep(step.id, step.order, step.action,
      step.id === id ? !step.done : step.done, step.note));
  });
  this.steps = next;
  ...
}

这里刻意没有用 map + 对象展开:ArkTS 的类型检查比 TS 严格,{ ...step, done: !step.done } 这种对类实例的对象展开、以及回调里直接返回匿名对象字面量,都会报 object literal must correspond to some explicitly declared class or interface;数组展开 [...this.tickets, newTicket] 在部分版本上也会因为元素"不可调用"直接失败。所以工程里统一成"新建数组 + forEach + push 一个 new ReproStep(...)",类型全程显式,编译器不用猜。同样的选择出现在 Index.ets:41-42 的开单逻辑里——那里用的是 concat 而不是数组展开。这两处不是风格偏好,是踩过之后的选择。

2.4 修复工单:状态机 + 归档

第四个工作面把前面三步的结论落到人身上:谁在修、修到哪一步、归档时留下什么。

鸿蒙PC 真机完整桌面:修复工单页,看板 3 张进行中工单卡(修复中/定位中/新建),下方"已验证归档 1 张"折行,右栏 03 流转规则与橙色告警联动说明

图 4 鸿蒙PC 真机完整桌面:窗口停在「修复工单」。01 看板·进行中并排 T1(修复中,端媒体组·沈书白)、T2(定位中,框架组·顾行舟)、T4(新建,平台组·竺一苇),每张卡带「推进」与关闭按钮;02 已验证归档 1 张(列表数据源空值守卫,阮清野);右栏 03 流转规则四行「新建 → 定位中 → 修复中 → 已验证」与橙色告警联动卡"同一异常 24 小时内新增超过 20 次且无对应工单时,看板顶部会出现「高频未开单」提醒"

状态机的实现在 Index.ets:47-64,是一个"三层三元"的推进函数:

const nextState: string = ticket.state === TICKET_NEW ? TICKET_LOCATING :
  ticket.state === TICKET_LOCATING ? TICKET_FIXING :
    ticket.state === TICKET_FIXING ? TICKET_VERIFIED : TICKET_VERIFIED;

这种写法在四个状态以内足够清晰,再多就该换成表驱动。它的正确性也藏了个小坑:最后一档 TICKET_VERIFIED 再推进还是 TICKET_VERIFIED,所以「已验证」的卡再点推进不会出错、也不会越界——这是兜底而非功能,写注释时要说清楚,否则下一个人会以为是 bug。

2.5 两处"只写在文案里"的门禁

这一章的重点来了。图 3 的验收约定写着"必须在两台不同内存档位的设备上走完本清单,且通过率不低于 80%“,图 4 的告警联动写着"24 小时内新增超过 20 次且无对应工单时会出现提醒”。我逐行查了代码,这两条都没有实现:

  • advanceTicket() 从「修复中」跳到「已验证」时,只判断状态,完全不读 passRate。也就是说通过率 20% 也能一键验收。
  • 「高频未开单」提醒只存在于 TicketView.ets:169-177 的一段静态文案里,hotErrors 只被用来算顶栏的"3 类高频异常",没有任何地方比较"高频且有工单"。

这就是排查工具最危险的状态:规则写在了 UI 上,约束没写进代码。补丁很小,加一个门槛字段和一个前置判断即可(Index.ets):

// 结构体成员:验收门槛,写死 80%,与界面文案同源
private readonly gateRate: number = 80;

private advanceTicket(id: string): void {
  const found: Ticket[] = this.tickets.filter((ticket: Ticket) => ticket.id === id);
  if (found.length === 0) {
    return;
  }
  const current: Ticket = found[0];

  // 门禁:从「修复中」转「已验证」前,复现清单通过率必须过线
  if (current.state === TICKET_FIXING && this.passRate < this.gateRate) {
    this.showToast('复现通过率 ' + this.passRate + '% 低于验收门槛 ' + this.gateRate +
      '%,工单保持「修复中」');
    return;
  }

  const nextState: string = current.state === TICKET_NEW ? TICKET_LOCATING :
    current.state === TICKET_LOCATING ? TICKET_FIXING : TICKET_VERIFIED;
  const next: Ticket[] = [];
  this.tickets.forEach((ticket: Ticket) => {
    if (ticket.id !== id) {
      next.push(ticket);
      return;
    }
    next.push(new Ticket(ticket.id, ticket.title, ticket.errorId, ticket.owner,
      nextState, ticket.tone, '刚刚',
      nextState === TICKET_VERIFIED ? '复现清单已通过,两设备验收完成' : ticket.conclusion));
  });
  this.tickets = next;
  this.showToast(current.id.toUpperCase() + ' → ' +
    (nextState === TICKET_LOCATING ? '定位中' : nextState === TICKET_FIXING ? '修复中' : '已验证'));
}

补完之后行为是"卡住 + 说明原因",而不是"点了没反应"或者"静默失败"——排查工具自己的交互也不该制造新的排查任务。

至于"两设备档位",deviceTag 现在只是 MateBook · 16GB 与 MatePad · 8GB 之间轮换的字符串(Index.ets:173-176),没有记录"这份清单在哪些档位上勾过"。要真做,得把 ReproStep 的 done 从 boolean 升级成 Set<string>(每个勾选记录设备档位),门禁改成"两个不同档位都有勾选记录且通过率 ≥ 80%"。这是一次数据结构改造,不是 UI 改造——凡是要算的规则,都得先在数据里留出位置,这是本文最想传达的一句话。

三、性能优化:鸿蒙PC 桌面形态下的四个真实热点

手机端的性能问题大多来自"数据多";鸿蒙PC 端的性能问题大多来自"窗口是变量"——宽度、高度、层级每秒都在变,而布局与绘制是按窗口尺寸算的。这一章四个热点全部是这一类:它们在小窗口的演示数据下几乎看不出来,一旦换到大屏、拖动窗口、或者数据量上一个量级就会立刻显形。

3.1 热点一:拖一次窗口,折线被重画了 60 次

折线画在 Canvas 上(OverviewView.ets:108-120),宽度靠 onAreaChange 回填:

Canvas(this.ctx)
  .width('100%')
  .height(170)
  .onReady(() => this.redraw())
  .onAreaChange((oldArea: Area, newArea: Area) => {
    const nextWidth = Number.parseFloat(newArea.width.toString());
    if (nextWidth > 0 && Math.abs(nextWidth - this.widthPx) > 0.5) {
      this.widthPx = nextWidth;
      this.redraw();
    }
  })

0.5 这个阈值在手机上是够用的(横竖屏切换只发生一次),在鸿蒙PC 上是失效的:拖动窗口边缘时,onAreaChange 会按帧回调,每帧宽度变化都远大于 0.5px,于是每一帧都执行一次 clearRect + 4 条网格线 + 7 个圆点 + 7 次数值 fillText + 7 次星期 fillText + 一条折线。更贵的是 Canvas 的像素缓冲:宽度一变就要按新的物理尺寸重建 surface,在 1600 像素宽的窗口上这是一次以 MB 计的重新分配。顺带一句:redraw() 里第 31 行声明了 labels 数组、第 71 行又声明了一个内容完全一样的 dayLabels,实际只用后者——同一个画布上两份重复的星期表,属于典型的"改一处忘一处"隐患。

改法是"把连续变化折叠成一次":宽度先记账,停手 120ms 再画。

private pendingWidth: number = 560;
private resizeTimer: number = -1;

private scheduleRedraw(width: number): void {
  this.pendingWidth = width;
  if (this.resizeTimer !== -1) {
    clearTimeout(this.resizeTimer);
  }
  this.resizeTimer = setTimeout(() => {
    this.resizeTimer = -1;
    // 拖动结束时才真正重画;宽度变化小于 8px 视为抖动,忽略
    if (Math.abs(this.pendingWidth - this.widthPx) > 8) {
      this.widthPx = this.pendingWidth;
      this.redraw();
    }
  }, 120);
}

调用处只改一行:.onAreaChange((_old: Area, area: Area) => this.scheduleRedraw(Number.parseFloat(area.width.toString())))。

第二个改法更彻底,也更符合 ArkUI 的分工:网格线与文字不该由 Canvas 画。截图里星期标签和数值都很小(context.font = '10px sans-serif'),中文在 Canvas 上走的是字体回落,每帧都要重新排版;把这部分换成 Text 组件叠在透明 Canvas 上,由布局系统负责排版与缓存,Canvas 只画一条折线和七个圆点,重绘成本能降一个量级。这是"用对组件"而不是"优化代码"——声明式 UI 的性能优化,一半是减少自己画的东西。

3.2 热点二:build() 里藏着 8 次遍历和 1 次排序

先看总览页的类别分布(OverviewView.ets:143-172)。四行统计,每行要算同一个类别的次数和——计算出现了两次:

Text(this.errors.filter((error: ErrorEvent) => error.category === category)
  .reduce((acc: number, error: ErrorEvent) => acc + error.count, 0).toString() + ' 次')
.width(Math.min(100, this.errors.filter((error: ErrorEvent) => error.category === category)
  .reduce((acc: number, error: ErrorEvent) => acc + error.count, 0) * 1.4) + '%')

四行 × 两次 = 每次渲染 8 次 filter + 8 次 reduce,外加头部 total() 的一次 forEach(:17-23)和榜单 hotErrors() 的一次 slice + sort(:78-82)。演示数据只有 5 条,这点开销可以忽略;但这条曲线的形状是 O(4 × 2 × n) + O(n log n),而 build() 会在每一次状态变化时重跑——包括切页签、点开单、勾复现步骤(父组件 @State 变了,子组件 @Prop 跟着刷新)。真实日志接进来是几百条、几千条,这就不是可忽略的开销了。

修法是把"派生"从渲染路径里搬出去,只算一次,并且一次算完:

class ErrorStat {
  total: number = 0;
  crash: number = 0;
  anr: number = 0;
  js: number = 0;
  net: number = 0;

  countOf(category: string): number {
    if (category === ERR_CRASH) {
      return this.crash;
    }
    if (category === ERR_ANR) {
      return this.anr;
    }
    if (category === ERR_JS) {
      return this.js;
    }
    return this.net;
  }
}
@Prop @Watch('onErrorsChange') errors: ErrorEvent[] = [];
@State private stat: ErrorStat = new ErrorStat();

aboutToAppear(): void {
  this.recompute();
}

onErrorsChange(): void {
  this.recompute();
}

private recompute(): void {
  const next: ErrorStat = new ErrorStat();
  this.errors.forEach((error: ErrorEvent) => {
    next.total += error.count;
    if (error.category === ERR_CRASH) {
      next.crash += error.count;
    } else if (error.category === ERR_ANR) {
      next.anr += error.count;
    } else if (error.category === ERR_JS) {
      next.js += error.count;
    } else {
      next.net += error.count;
    }
  });
  this.stat = next;
}

渲染处从 this.errors.filter(...).reduce(...) 变成 this.stat.countOf(category),从"每次渲染遍历 8 遍"变成"数据变了才遍历 1 遍,读取 O(1)“。这里用 @Watch 而不是在 build() 里判断"数据变没变”,是因为 build() 必须保持纯函数:它只读状态、不写状态、不做重计算。ArkUI 没有 Vue 那样的 computed,@Watch + @State 缓存就是官方等价物。

榜单排序同理,把 hotErrors() 的结果一起塞进 recompute(),保存成 @State private ranked: ErrorEvent[],渲染时直接 ForEach(this.ranked, ...)。注意排序结果必须和统计一起更新,否则会出现"类别分布变了、榜单没变"的半刷新状态——这类问题在排查工具里比性能问题更致命。

3.3 热点三:ForEach 的 key 里拼了状态,等于放弃复用

ForEach 的第三个参数是 key 生成器,ArkUI 的 diff 只认 key:key 不变就复用旧节点,key 变了就销毁旧节点、重建整棵子树。工程里两处把状态拼进了 key:

// ReproView.ets:88
}, (step: ReproStep) => step.id + step.done.toString())

// TicketView.ets:105
}, (ticket: Ticket) => ticket.id + ticket.state)

后果很具体:勾一下复现步骤,那一行(勾选圆圈 + 两条文字 + 一个 MarkPill + 图标 Path)整行被重建,橙色/橄榄色的过渡没有、hover 态丢失、PC 上表现为"点一下闪一下";推进一次工单,卡片整张重建,ChoiceBtn 的 @State hovered 归零,鼠标停在按钮上时按钮会突然复位。演示数据只有 5 行 3 张卡,人眼能忍;真实场景 50 行就是每次交互重建 500 个节点。

正确姿势是key 只放稳定标识,可变字段交给可观察对象:

@Observed
export class ReproStep {
  id: string;
  order: number;
  action: string;
  done: boolean;
  note: string;

  constructor(id: string, order: number, action: string, done: boolean, note: string) {
    this.id = id;
    this.order = order;
    this.action = action;
    this.done = done;
    this.note = note;
  }
}

@Component
struct StepRow {
  @ObjectLink step: ReproStep;
  onToggle: (id: string) => void = () => {};

  build() {
    Row({ space: 12 }) {
      Row()
        .width(26)
        .height(26)
        .borderRadius(13)
        .backgroundColor(this.step.done ? ChoiceColors.olive : ChoiceColors.white)
        .border({ width: 2, color: this.step.done ? ChoiceColors.olive : ChoiceColors.gridStrong })
      Column({ space: 3 }) {
        Text(this.step.order + '. ' + this.step.action)
          .fontSize(13)
          .fontColor(this.step.done ? ChoiceColors.olive : ChoiceColors.ink)
        Text(this.step.note)
          .fontSize(10.5)
          .fontColor(ChoiceColors.muted)
      }
      .alignItems(HorizontalAlign.Start)
      .layoutWeight(1)
    }
    .width('100%')
    .padding(13)
    .borderRadius(10)
    .border({ width: 1, color: this.step.done ? ChoiceColors.olive : ChoiceColors.grid })
    .onClick(() => this.onToggle(this.step.id))
  }
}
ForEach(this.steps, (step: ReproStep) => {
  StepRow({ step: step, onToggle: (id: string) => this.onToggleStep(id) })
}, (step: ReproStep) => step.id)

注意两点。第一,@ObjectLink 必须配 @Observed 的类,缺一个都不生效——这是 ArkUI 里最容易漏的一对。第二,父组件仍然保留"整体替换数组 + 重算 passRate"的逻辑,不要为了省一次遍历改成原地改对象:passRate 是父组件的派生值,它需要一次明确的重算时机。子组件局部刷新、父组件显式重算,这个分工比分层订阅更好维护。

3.4 热点四:帧数据每次渲染都重新 new 一遍

StackView.ets:20-22 只有三行,但它坐在渲染路径上:

private frames(): StackFrame[] {
  return seedFrames();
}

seedFrames()(Models.ets:153-162)每次调用要新建 5 个 StackFrame 实例和 1 个数组。5 帧无感;真实的 Native 崩溃栈常常 30~80 帧,而且 StackView 还嵌在 Scroll 里,滚动触发重排时可能重跑。改法很简单:

private readonly frames: StackFrame[] = seedFrames();

在字段初始化时建一次,渲染只读。**“渲染函数里不做事、只取值”**这条原则在这一个字段上体现得最直白。

顺带一个更结构性的问题:全工程没有 List、没有 LazyForEach、没有 Repeat,所有列表都是 Scroll + Column + ForEach(我 grep 过,三类 API 零命中)。这在演示数据下是合理选择——Column 简单、没有回收带来的状态同步麻烦。判据可以写死成一条工程约定:单列表条目超过 50,或单行节点超过 8 个,就必须换 List + LazyForEach。因为鸿蒙PC 的窗口高度可以从 600 拉到 1400,Column 在两种高度下都会把全部子节点建完,而 List 只建可视区。

表 3 四个热点的改前改后对照

热点现状触发频率改后
Canvas 重绘onAreaChange 超过 0.5px 即全量重画拖动窗口时约 60 次/秒停手 120ms 画 1 次,且小于 8px 忽略
派生统计build() 内 8 次 filter+reduce、1 次累加、1 次排序每次状态变化数据变更时 1 次 O(n),读取 O(1)
ForEach keykey 里拼 done / state每次勾选、每次推进key 稳定,仅属性级刷新
帧数据每次渲染 new 5 个对象每次状态变化字段初始化一次
列表容器Scroll + Column,无虚拟化全量建节点List + LazyForEach,只建可视区

五行的共同点值得点出来:这五处"优化"没有一处需要改业务逻辑。它们不是让功能更快,而是让同一份功能少做无用的重复劳动。鸿蒙PC 上的性能问题大多是这个形状——不是算法差,是重复做。

四、数据口径治理:同一个屏幕上,64 和 134 谁对

第三章讲的是"算得慢",这一章讲"算得不对",后者更严重。

同一屏幕上的两个总计:七日趋势合计 64 次,异常榜单合计 134 次,以及把趋势改成由 errors 派生后的处理方式

图 5 左边是七日趋势的七根柱(6/9/4/12/7/15/11,合计 64),右边是异常榜单五条(37/54/23/12/8,合计 134)。两个数字都自称"总异常次数",差距 70 次。下方红框是处理方式:趋势必须由同一份 errors 派生

根因在 Models.ets:dailyCounts() 与 seedErrors() 是两份互不相关的常量。

export function dailyCounts(): number[] {
  return [6, 9, 4, 12, 7, 15, 11];
}

export function seedErrors(): ErrorEvent[] {
  return [
    new ErrorEvent('e1', 'ndk图像解码空指针 SIGSEGV', ERR_CRASH, 37, '11-12', '今天 14:20', '相册批量导入', ChoiceColors.red),
    new ErrorEvent('e2', '主线程序列化超时触发 ANR', ERR_ANR, 12, '11-13', '今天 11:05', '首次启动恢复会话', ChoiceColors.orange),
    new ErrorEvent('e3', '列表项 undefined 读取 TypeError', ERR_JS, 54, '11-10', '昨天 18:44', '设置页快速滚动', ChoiceColors.slate),
    new ErrorEvent('e4', '上报接口 502 未重试', ERR_NET, 23, '11-11', '昨天 09:12', '弱网环境批量上报', ChoiceColors.graphite),
    new ErrorEvent('e5', '大图 Bitmap OOM', ERR_CRASH, 8, '11-13', '11-14', '高清预览连拍', ChoiceColors.red)
  ];
}

界面头部显示"近 7 日总计 134 次"(来自 errors 累加),下面的折线却来自另一份数组(合计 64)。这类问题在排查工具里属于自毁信任:用户看到两个总和对不上,会立刻怀疑整块面板的数据。而且它极难被测出来——没有崩溃、没有报错、类型检查全过。

要修,第一步是让数据有能力被算:把 lastSeen 从"今天 14:20"这种人类可读字符串升级成毫秒时间戳,字符串只用于展示。

export class ErrorEvent {
  id: string;
  title: string;
  category: string;
  count: number;
  firstSeen: string;
  lastSeenMs: number;   // 新增:用于时间桶聚合
  scene: string;
  tone: string;

  constructor(id: string, title: string, category: string, count: number,
    firstSeen: string, lastSeenMs: number, scene: string, tone: string) {
    this.id = id;
    this.title = title;
    this.category = category;
    this.count = count;
    this.firstSeen = firstSeen;
    this.lastSeenMs = lastSeenMs;
    this.scene = scene;
    this.tone = tone;
  }
}

种子数据也要跟着改。下面用 new Date(2026, 10, 15, 14, 20) 表示 11 月 15 日 14:20(月份从 0 开始数,所以 10 是十一月),展示层再用 formatSeen(lastSeenMs) 现场拼出"今天 14:20":

export function seedErrors(): ErrorEvent[] {
  return [
    new ErrorEvent('e1', 'ndk图像解码空指针 SIGSEGV', ERR_CRASH, 37, '11-12',
      new Date(2026, 10, 15, 14, 20).getTime(), '相册批量导入', ChoiceColors.red),
    new ErrorEvent('e2', '主线程序列化超时触发 ANR', ERR_ANR, 12, '11-13',
      new Date(2026, 10, 15, 11, 5).getTime(), '首次启动恢复会话', ChoiceColors.orange),
    new ErrorEvent('e3', '列表项 undefined 读取 TypeError', ERR_JS, 54, '11-10',
      new Date(2026, 10, 14, 18, 44).getTime(), '设置页快速滚动', ChoiceColors.slate),
    new ErrorEvent('e4', '上报接口 502 未重试', ERR_NET, 23, '11-11',
      new Date(2026, 10, 14, 9, 12).getTime(), '弱网环境批量上报', ChoiceColors.graphite),
    new ErrorEvent('e5', '大图 Bitmap OOM', ERR_CRASH, 8, '11-13',
      new Date(2026, 10, 14, 10, 3).getTime(), '高清预览连拍', ChoiceColors.red)
  ];
}

把可读字符串存进数据里,是排查工具最常见的腐坏源:"今天 14:20"在三天后就成了谎话,而毫秒时间戳永远可以重新格式化。这条改动看起来只是改字段类型,实际是把"时间的解释权"从写入方交给展示方。

第二步,趋势改成纯派生函数,输入只有 errors 和"今天":

private trendFromErrors(): number[] {
  const buckets: number[] = [0, 0, 0, 0, 0, 0, 0];   // 下标 6 是今天,0 是六天前
  const dayMs: number = 86400000;
  const todayZero: number = new Date().setHours(0, 0, 0, 0);
  this.errors.forEach((error: ErrorEvent) => {
    const seenZero: number = new Date(error.lastSeenMs).setHours(0, 0, 0, 0);
    const daysAgo: number = Math.floor((todayZero - seenZero) / dayMs);
    if (daysAgo >= 0 && daysAgo < 7) {
      buckets[6 - daysAgo] += error.count;
    }
  });
  return buckets;
}

第三步,加一条开发期断言,把"两个总和对不上"变成能被发现的问题:

private assertTrendConsistency(): void {
  let sum: number = 0;
  this.trendFromErrors().forEach((value: number) => {
    sum += value;
  });
  if (sum !== this.stat.total) {
    console.warn('[ERRTRACE] 趋势合计 ' + sum + ' 与榜单合计 ' + this.stat.total + ' 不一致');
  }
}

改完之后会发生一件很有意思的事:折线只剩两根柱子——今天 49 次(e1 的 37 + e2 的 12),昨天 85 次(e3 的 54 + e4 的 23 + e5 的 8),合计 134 次,与榜单一致。前面五天全是 0,因为演示数据的时间密度本就不真实(三条挤在昨天)。这恰恰说明"派生"比"另写一份"更有价值:它不仅让数字对上,还把数据本身的分布缺陷暴露出来了。如果继续用手写的 [6,9,4,12,7,15,11],这块永远显示不出来的。

顺带把同一类问题在工程里的另一处也点一下:StackView.ets:158-171 的 StatReadStub 把"疑似帧"直接写成 Text('2')。现在它恰好等于 seedFrames() 里 suspect: true 的两帧,看起来是对的,但一旦有人把第 3 帧也标成疑似,这个 2 就成了谎言。改成 this.frames.filter((frame: StackFrame) => frame.suspect).length 才是"派生"。

五、方案选型治理:为什么这个台面是 ArkUI,而不是再套一层跨平台框架

前面四章解决"这一版怎么改"。这一章解决一个更贵的问题:下一版要不要换框架。这类决策一旦做错,代价不是改几十行代码,而是两条工具链、两套 CI、两个招聘方向。

先给结论:这个工程应该继续用 ArkUI 原生,不引入任何跨平台框架。但结论不是从"我喜欢 ArkTS"来的,而是从三条硬约束推出来的。

约束一:能力密度集中在桌面独有的部分。 这套台面真正费工的四个交互——鼠标 hover 反馈(ChoiceBtn 里的 @State hovered)、窗口宽度驱动的 Canvas 重排、双设备档位切换、四视图互斥切页——全部贴着 2in1 桌面形态。换任何一个跨平台框架,这些能力都需要"宿主 → 桥 → 平台 API"的一跳,而鸿蒙PC 侧的平台 API 本身还在演进(SDK 26.0.0 这一代 window、display、拖拽相关接口都还有变动),桥会先于业务腐烂。

约束二:产物代价。 纯 ArkTS 工程打出来是一个 HAP,没有额外运行时。而主流跨平台框架在鸿蒙上都要带一份运行时:Flutter 带 engine,Kotlin/Compose Multiplatform 带 skiko 与一堆 .so。我在另一套 KMP + Compose Multiplatform 的鸿蒙PC 工程上量过:debug 双 ABI HAP 61.7 MB(其中 libkn.so 占 57.7 MB),release 压到 40.6 MB。对内部工具无所谓,但这套台面天然要贴着崩溃日志工作,越靠近故障现场的工具越应该轻——一个 40 MB 的工具去分析一个几十兆应用的崩溃,本身就有点荒诞。

约束三:团队只有一端的交付压力。 跨平台框架的收益来自"多端复用",而这里没有第二端。它只服务鸿蒙PC。用跨平台框架,等于付了两端工具链的成本,只拿一端的收益。

表 4 四套方案在这个台面上的对照(判据而非结论)

维度ArkUI 原生(本文)ArkUI-XFlutterCompose Multiplatform
跨平台框架定位单端优先,跨端靠 ArkUI-X 延伸ArkUI 的跨平台延伸层自带渲染引擎的全栈跨平台框架Kotlin 生态的跨平台 UI 框架
鸿蒙PC 桌面能力(hover / 焦点 / 窗口尺寸 / 多窗口)直接可用,无需桥需插件桥接,桌面能力覆盖取决于桥需 engine 通道与平台插件需 ohos 变体 + expect/actual 平台层
产物与启动单 HAP,无额外运行时依赖双端工具链带 engine,包体显著增加带 skiko,参考工程 release HAP 40.6 MB
三方生态ohpm(@ohos.*、@kit.*)双栈pub 生态 + ohos 适配层Maven 生态 + ohos 变体
与 PC 输入模型契合度高(原生手势、hover、键盘事件齐全)中中中
团队成本一套 ArkTS + DevEco两套工具链Dart + 平台层Kotlin + 平台层
本例适用判据单端、桌面能力强依赖、包体敏感已有大量 ArkUI 资产需上多端已有 Flutter 存量且要三端同款 UI已有 KMP 业务层且要复用 UI

必须说明的一点:ArkUI 和 ArkUI-X 不是一回事。本文工程是 ArkUI(声明式 UI 框架)在鸿蒙PC 上的原生应用,deviceTypes: ['2in1']、@kit.ArkUI、@kit.AbilityKit 直接调用,没有任何跨端中间层;ArkUI-X 是"把 ArkUI 能力延伸到其他平台"的那一层。把两者混着说,会让读者误以为这个工程跑在跨端容器里——这是技术写作里最常见的失真之一。

5.1 什么时候应该反过来选跨平台框架

反过来选的判据也很清楚,一共四条,命中两条以上就该认真评估:

  1. 已有存量资产。团队已经有一套 Flutter / Compose 的界面与业务代码,鸿蒙PC 只是新加的一个端。此时重写远贵于桥接。
  2. 要复用的不只是 UI,而是完整的产品逻辑。跨平台框架真正值钱的是"同一套状态管理 + 同一套路由",不是"同一套按钮样式"。
  3. 多端同款是产品需求。比如同一个排查台要同时出现在 Windows 客户端与鸿蒙PC 上,要求像素级一致。
  4. 团队没有 ArkTS 储备,但有 Dart / Kotlin 储备。人比框架贵。

这套台面四条全部不命中:没有存量、不需要三端、只要鸿蒙PC、团队就在写 ArkTS。所以选 ArkUI 原生不是保守,是成本最低的正确答案。

5.2 一条中间路线:把"能带走的"和"带不走的"分开

真正成熟的选型治理不是"一次选死",而是把可迁移的部分做成不依赖 UI 框架的纯函数。本文工程里已经有天然的候选:OverviewView 里 total() 的累加逻辑,加上第三章的 ErrorStat 与第四章的 trendFromErrors()。它们只吃数组、只吐数字,没有任何 ArkUI 依赖——也就是说,如果三年后真要换框架,这两个函数可以原样搬走,只有 build() 需要重写。

所以我的建议是把这条边界写成工程约定:common/ 目录下的计算逻辑禁止 import 任何 @kit.ArkUI 或组件;components/ 只做渲染;pages/ 只做装配。本文工程目前基本是这个形状(common/Theme.ets 只有色板常量,common/Models.ets 只有模型与种子数据),保持住就行。选型治理的产物不是一次会议纪要,而是一条能被 import 检查出来的边界。

5.3 接真日志的落地路径(本工程尚未接,这里给路线不给臆测)

界面上的 134 次、37 次都是本地常量,工程没有读系统日志。要变成真工具,鸿蒙侧有两条现成的数据源:

数据源能拿到什么关键点
FaultLogger(@kit.PerformanceAnalysisKit)应用自身的 JS 崩溃、CPP 崩溃、无特定类型故障日志导出名首字母大写是 FaultLogger;FaultType 只有 NO_SPECIFIC / CPP_CRASH / JS_CRASH 三档,没有笼统的 CRASH;查询自身故障日志不需要额外申请权限
hiAppEvent(@kit.PerformanceAnalysisKit)OS 域事件:应用启动、滑动卡顿、应用冻屏、资源超限事件常量在 hiAppEvent.event 下,是小写形式;订阅用 addWatcher,可按 domain + names 过滤

这三处细节我是在另一套鸿蒙PC 工程上实测踩出来的,写在这里是为了让读者少走一遍:FaultLogger 的导出名大小写、FaultType 的枚举档位、事件常量的命名空间,三个都是"文档翻三遍才能确认、编译器一报就懂"的地方。

数据接进来之后,本文的四步链一行都不用改,只需换掉 seedErrors():异常总览的排序键要升级成"次数 × 影响用户数",堆栈归因要吃 FaultLogger 的原始偏移 + 符号文件做离线还原,复现路径的门禁要落库(否则重启就丢),工单要落文件或数据库。四步链是骨架,数据源是血肉——先有骨架再接血肉,比反过来省力得多。

六、工程治理:908 行孤儿组件、一份漂移的元数据

前五章都在讲"怎么把功能做对",这一章讲"怎么把工程收拾干净"。它不产生新功能,但决定这个仓库三个月后还能不能维护。

问题一:四个没人引用的组件,合计 908 行。 工程里 15 个 .ets 共 2505 行,其中 MatrixView.ets(292 行)、DecisionView.ets(214 行)、RiskView.ets(183 行)、ReviewView.ets(219 行)没有任何地方引用——Index.ets 只 import 了 OverviewView / StackView / ReproView / TicketView 四个视图。这 908 行占全工程 36.2%。

更要命的是它们已经断了。MatrixView.ets:2 写着:

import { CandidateOption, Criterion } from '../common/Models';

但 Models.ets 里根本没有 CandidateOption、Criterion。同理还有 ReviewView 的 ReviewVote、DecisionView 的 DecisionRecord 与 ADR_ACCEPTED/ADR_PROPOSED/ADR_REJECTED/ADR_SUPERSEDED、RiskView 的 RiskItem 与 riskLevel / riskLevelTone。这些符号在 common/ 下一个都不存在。

它们之所以"看起来是绿的",是因为构建从入口 pages/Index 与 EntryAbility 开始解析模块图,不被引用的文件不进编译图。这是 tree-shaking 的正常行为,但它同时意味着:死代码不会被编译器报警。这四棵树原本是另一个产品形态(“方案选型矩阵 + ADR 决策记录 + 风险清单 + 评审投票”)的界面,oh-package.json5 里 name: 'adjudra-vault-console'、description: 'Permission and privacy vault console for HarmonyOS PC.' 还留着上一代"权限与隐私金库"的痕迹——这是一个典型的壳工程复用导致的元数据漂移。

治理动作有三条,都很便宜:

  1. 删。要么删掉这 4 个文件,要么把对应模型补回 Models.ets 并真正接进 Index.ets 的第五、第六个页签。不要留着"以后可能用"的断链代码——它每存在一天,下一个人就要多花十分钟确认它是不是活的。
  2. 把"可达性"变成 CI 检查。从 main_pages.json 与 mainElement 出发做一次模块图可达性遍历,列出"存在但不可达"的 .ets,超过阈值就失败。二十行脚本的事。
  3. 修元数据。oh-package.json5 的 name 与 description 改成与应用一致(adjudra-errconsole / “崩溃与异常排查指挥台 for HarmonyOS PC”)。这类漂移不影响编译,但会让 ohpm 的依赖图、制品库检索、以及后来者的第一印象全部错位。

问题二:桌面可用性的三项缺口。 我在全工程搜过,onKeyEvent、focusable、focusOnTouch、tabIndex 零命中。这意味着这套台面在鸿蒙PC 上只能靠鼠标操作:不能 Tab 在四个页签之间移动焦点、不能用 Enter 触发「推进」、方向键翻不了堆栈帧。手机端这样写没问题(触摸就是唯一输入),鸿蒙PC 端这是可用性缺陷——桌面用户有键盘,而且默认认为键盘应该能用。

补法不复杂:给页签与 ChoiceBtn 加 focusable(true)、.onKeyEvent((event: KeyEvent) => { ... }) 处理 Enter / Space,用 tabIndex 固定遍历顺序,焦点态用 border 或 outline 显式画出来(ChoiceBtn 现在只有 @Component 内部的 hovered,没有 focused)。

问题三:窗口宽度断点。 OverviewView 的主区是"折线卡 layoutWeight(1) + 分布卡固定 240",TicketView 是"看板 layoutWeight(1) + 规则栏固定 310"。窗口收窄到 900px 以下时,固定宽度栏会开始挤压主区;再窄,ForEach 出来的三张工单卡(每张 layoutWeight(1))会挤成三根"薯条"。演示用的全屏窗口不会暴露这个问题,用户把窗口拉成一半就会。鸿蒙PC 的适配主要工作就是这件事:不是"能不能显示",而是"少一半宽度时先牺牲谁"。

表 5 治理清单(按性价比排序)

项证据动作优先级
908 行孤儿组件Index.ets 仅 import 四个视图;四个文件引用不存在的类型删除或补全模型并接入高
元数据漂移oh-package.json5 的 name / description改名改描述高
门禁未落地advanceTicket() 不读 passRate加 GATE_RATE 前置判断(第二章补丁)高
趋势与榜单口径不一致dailyCounts() 合计 64 vs errors 合计 134改派生 + 断言(第四章补丁)高
键盘不可用全工程无 onKeyEvent / focusable页签与按钮补焦点与按键中
小窗口挤压固定 240 / 310 侧栏加宽度断点,窄屏侧栏下沉中
ForEach key 抖动ReproView.ets:88、TicketView.ets:105稳定 key + @Observed中
疑似帧硬编码StackView.ets:164 的 '2'改为 filter 计数低
无列表虚拟化全工程无 List / LazyForEach条目 > 50 时再上低

七、可以照着做的八步核对清单

如果你手上也有一块鸿蒙PC 上的排查/治理台面,下面八条可以逐条对照,每条都对应本文一个具体的坑:

  • 一屏之内只能有一个"总计"。头部统计、趋势图、榜单的合计必须来自同一份数据;任何"另写一份常量"的图表都要按第四章改派生,并加断言。
  • 门禁必须写进代码,不能只写在文案里。凡是界面上写着"必须满足 X 才能 Y",就去 grep 一遍 X 对应的变量有没有在 Y 的分支里被读。本文的两处门禁都是空的。
  • build() 里不许有循环。filter / reduce / sort / new 一律搬到 aboutToAppear + @Watch 的缓存里,build() 只读字段。
  • ForEach 的 key 里不许拼状态。key 只放 id;可变字段用 @Observed + @ObjectLink。
  • 窗口宽度变化要折叠。onAreaChange 直连重绘在鸿蒙PC 上等于给拖动窗口加了一个 60fps 的负载,加 100~150ms 的合并与一个像素阈值。
  • Canvas 只画图形,文字交给 Text。中文在 Canvas 上每帧重新排版,成本与清晰度都吃亏。
  • 桌面端要有键盘路径。focusable + onKeyEvent + 可见焦点态,是 2in1 形态的最低要求。
  • 定期扫一遍不可达文件。死代码不会被编译器报警,只会被下一个人骂。

八、结语:排查工具的第一性原理是"可核对"

回到那个 64 与 134。这篇文章如果只能留一句话,我会留这句:排查工具自己必须先可被排查。它吐出的每个数字,都要能顺着一行代码找到来源;它承诺的每条规则,都要能在代码里找到那个 if;它展示的每个箭头,都要能在数据结构里找到对应的字段。做不到这三条的工具,最后都会退化成"一块看起来很专业的看板"——而看板解决不了任何问题。

配套工程「勘误 · Errtrace」目前在鸿蒙PC 真机上跑通了四步闭环:异常总览排序、堆栈归因标注、复现清单折算、工单状态机归档。它的价值不在界面,而在这条链的形状:每一步都有交付物(榜单条目、疑似帧、勾选记录、归档结论),每一步都有约束(次数阈值、符号化范围、通过率 80%、状态机不可跳跃)。文中给的补丁——门禁拦截、派生统计缓存、稳定 key、趋势派生、断言——都是在这条形状上做加固,而不是换形状。

下一步最值得做的不是继续美化界面,是把 seedErrors() 换成真的 FaultLogger 与 hiAppEvent(第五章给了路线与三个坑)。数据一真,前面所有的性能与口径问题都会立刻从"演示级"变成"生产级",而这正好是这套台面存在的意义。

配套工程源码位于 项目源码/Adjudra_ohos,可按表 1 的基线逐项核对;工程可直接以 AtomGit 托管(开源鸿蒙PC 社区项目入口就在那里)。文中的四张真机截图均为鸿蒙PC 完整桌面截图,未做裁剪与拼接;两张示意图按工程实际分支与常量重绘,数值与 common/Models.ets 一致。如果你在鸿蒙PC 上也有一块类似的台面,欢迎按第七章的八条清单逐项对一遍——大概率能扫出两三个你没注意到的"看起来对"。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐