Tauri动态性能仪表鸿蒙PC实战:用户说「太假了」,改成每 380ms 真跑一帧的活仪表
动态性能仪表鸿蒙PC实战:用户说「太假了」,改成每 380ms 真跑一帧的活仪表
性能对比页我第一版交的是一张铺满数字的静态表:6 行构建产物字节数、9 行运行时指标、条形图、测量方法、硬限制清单,整整齐齐。用户点开只回了一句「性能对网页太假了,可以去掉一些指标,搞成动态的」——那一句把我钉住了:数字全是我硬编码进 JS 的常量,页面从头到尾没跑过一行基准,它当然像张截图。于是我把主界面里的性能功能改成计时器驱动的活仪表,每 380ms 真的执行一批
JSON.stringify/innerHTML/getElementById,大数字、条形、折线随真实累加跳动;又用包装MallApp.setView的办法接进主界面,让app.js正文一个字符都不用改。这篇文章用一个跑在 ArkWeb 里的商城单页,把「静态报表假在哪」「数字会动和真的在跑差在哪」「零侵入接进已有 2932 行主逻辑怎么做到」这三个问题一次讲透。
仓库地址:/storage/Users/currentUser/Documents/DevEcoStudioProjects/tauri-hello(本系列实战工程,ArkWeb + JSBridge 承载的鸿蒙 PC 商城);新增主界面动态仪表 js/perf-panel.js、改造独立报告页 perf.html + js/perf-bench.js,无三方库依赖,纯 ES5 语法,node --check 可直接验;预览地址 http://127.0.0.1:8099/index.html(切「性能优化」Tab)与 http://127.0.0.1:8099/perf.html。
- 开源鸿蒙 PC 社区:https://harmonypc.csdn.net/
- 在 PC 社区申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
- 社区地址:https://atomgit.com/oh-tpc
- Rust 工具链发行页:https://atomgit.com/bytecheers/ohos-rust-release
- Tauri 源码镜像:https://atomgit.com/GitHub_Trending/ta/tauri
- 项目相关代码:https://atomgit.com/nutpi/tauri-demo
整体功能演示:
项目源码位置:https://atomgit.com/dijun_520/tauri-ohos-mall

0. 环境与实测设备
| 项 | 版本 / 型号 |
|---|---|
| 设备 | HarmonyOS PC(aarch64,API 26,2in1 形态) |
| 系统 | HarmonyOS,PC 发行版 |
| DevEco Studio | 鸿蒙电脑版(26.0.0.220) |
| 鸿蒙 SDK | API 26(compatibleSdkVersion 26.0.0) |
| Tauri | 2.11.5(走 feat/open-harmony 分支) |
| Rust | 1.89.0(本机原生版) |
| 目标三元组 | aarch64-unknown-linux-ohos |
@ohos-rs/ability | 0.4.x(0.2.1 有白屏 bug,不碰) |
| 构建宿主 | macOS(Apple Silicon),交叉编译用 |
| 目标架构 arm64-v8a | |
| SDK 宿主工具平台 | x86-64 Linux(这是关键,下面会反复回到它) |
| 真机型号 | HUAWEI MateBook Pro HAD-W24 |

先把口径钉死:这一屏的毫秒是 JS 层函数耗时,不是真机帧率,不是首帧时间,不是 ArkTS 侧耗时。 数字会跳,是因为代码真的在跑;但跳得多快、每一帧耗多少,跨机器跨浏览器都不能直接比。我能承诺的只有一件事:页面上每一个计数都来自代码路径里的真实累加,没有一处用随机数伪造。这句话看着朴素,恰恰是这轮返工最核心的一条边界,后面第 6 节会专门讲我差一点怎么把它破坏掉。
1. 问题是怎么找上我的:我以为「有张对比表」就算交了
商城做到第四批业务页面之后,app.js 已经涨到 144057 字节、2932 行。前一轮我为了给性能优化配一个「能显示详细对比结果的界面」,单独做了 perf.html:进去自动跑一次基准,然后整页铺开——6 行构建产物字节数、9 项运行时指标、三组条形对比、测量方法、7 条硬限制清单。数字是真的,来自一次完整的 assembleHap / assembleApp 实测,我在文章里还专门解释了「签名产物带时间戳,重复构建会浮动几字节,所以固定记录那一次构建完成时刻」。
我自认为口径交代得够清楚了。结果用户打开页面,回的是这句:
性能对网页太假了,可以去掉一些指标,搞成动态的
「太假」两个字,一开始我理解成「数字不够可信」。回去翻代码才明白不是那么回事。问题出在 perf-bench.js 里这段:
// js/perf-bench.js - STATIC_ROWS(返工前,节选)
var STATIC_ROWS = [
{ metric: 'signed HAP 体积', unit: 'B', original: 854714, current: 665676, ... },
{ metric: 'unsigned HAP 体积', unit: 'B', original: 825707, current: 635026, ... },
{ metric: '签名块增加', unit: 'B', original: 29007, current: 30650, ... },
{ metric: '上架 APP 体积(signed)', unit: 'B', original: 0, current: 651469, ... },
{ metric: 'APP 包内文件数', unit: '个', original: 0, current: 3, ... },
{ metric: '构建耗时', unit: 'ms', original: 14607, current: 17138, ... }
];
这 6 行是我敲进源码的常量。页面加载时 render() 把它们拼成 <table>,之后再也不动。用户盯着看多久,854714 就是 854714。更要命的是主界面那个性能 Tab,我第一版也照抄了这套:一个「静态产物基线」区块、一个 9 行「详细对比结果」表,全是加载时算一次就定死。两屏叠在一起,观感就是两张打印出来的报表——数字再真实,它也是死的。
而且主界面这一版还有个更根本的问题:用户平时打开的是 index.html,perf.html 是独立页,主界面里连个入口都没有。也就是说,用户想看性能对比,得知道有个单独的文件、手动敲地址。做完功能却让人点不到,等于没做。
所以这个题目的边界,被用户那句话重新钉死了:不是「把真实数字摆出来」,而是「让数字在屏幕上因为真实执行而持续变化」,并且「在主应用里能点得到」。 拆开来是三件事:
- 砍掉写死的静态产物指标,把主界面改成计时器驱动、每帧真跑的活仪表;
- 独立报告页不能还是一屏死表,得改成自动重跑,把最假的那 6 行折叠弱化;
- 主界面接进这套功能,但不许改
app.js正文——前面几篇文章里钉了大量app.js:1981这类源码锚点,插一行就全漂。
下面是干完之后的完整记录,包括我踩的每一个坑。
2. 效果展示
按老规矩,先给效果再讲原理。

图1 主界面「性能优化」Tab:运行控制条 + 四个跳动大数字 + 实时条形 + 真实耗时折线
这一屏最上面是运行控制条:● 实时重跑中 的状态灯在呼吸,「⏸ 暂停」按钮,慢/中/快三档速度,右侧 已运行 12.4s · 31 tick · 124 次交互 · performance.now()。这里每一行都不是装饰:状态灯来自 live.running,tick 数是 live.ticks,交互数是 live.totalActions,计时方式是运行时探测 performance.now() 是否存在的结果——在 Web 里是 performance.now(),在退化环境里会显示 Date.now()。

下面四个大数字卡是整屏的主角:累计交互、原始实现干活次数、优化实现干活次数、省下的工作量。它们每次 tick 重写一遍,带一个 0.28 秒的 pfp-bump 缩放动画。注意动画只是视觉,数值本身来自 tally 里的累加器,不是动画算出来的。

图2 左侧条形随累计实时伸缩,右侧折线是最近 40 个 tick 的真实耗时采样
左边三组条形(序列化 / 重绘 / 查询),原始实现那根一路变长,优化实现那根几乎贴着左边缘——因为脏标记和查询缓存把绝大多数调用跳过了。右边那条折线是 SVG <polyline>,两条线分别是原始实现、优化实现在每一个 tick 里 performance.now() 现测的耗时,数组只留最近 40 个点,每 tick shift() 掉最老的一个,所以看起来在向左滚动。纵轴峰值会随采样变化,也是实算的。

图3 独立页 perf.html:自动重跑控制条 + 真实耗时曲线,构建产物快照折叠收起
独立页顶上多了一条 pf-autobar,第 N 次重跑 一直在涨,下面的曲线是最近 N 次完整基准的原始/优化耗时。原来占满一屏的「构建产物基线」被收进 <details>,默认折叠,标题直白写着「一次历史构建快照 · 固定不变」。想单独看整页详细对比的,从主界面 Debug 区点「打开独立详细对比界面 →」就到这儿。

三张图有个共同点:截图里没有任何一个数字是我预先写进 HTML 的。这是和第一版最本质的区别。
3. 原理:一屏「活的」数字,到底要跨过哪几层
先把最要紧的模型判断放这儿:数字会动,不等于代码在跑。 用 Math.random() 配个 setInterval 一样能让大数字跳得欢,但那是动画,不是测量。这一轮我给页面定的硬规矩是——每一帧必须先真实执行一批业务交互,把计数器累加完,再拿累加结果去重绘 DOM。顺序不能反。
整个链路拆成四层,用一张表说清谁触发谁、谁回答什么:
| 层 | 触发 | 干什么 | 产出 |
|---|---|---|---|
| 计时层 | setInterval(runTick, 380) | 按速度档每帧调一次 runTick | 一个 tick 的时间片 |
| 执行层 | doAction() × 2 套实现 | 真跑 JSON.stringify / innerHTML / getElementById | 六项打点计数 + 真实耗时 |
| 累加层 | accum() → tally | 按策略把本帧计数并进累计仪表 | 累计工作量、省下比例、折线采样点 |
| 渲染层 | renderAll() | 重绘大数字 / 条形 / 折线 / 详细表 / 状态条 | 用户看到的这一屏 |
计时层只是发令枪,值钱的东西全在执行层。 这句话决定了后面所有的实现选择:折线画的是执行层每帧现测的耗时,不是计时层的间隔;大数字读的是累加层的计数器,不是 Date.now() 减启动时间凑出来的假数;暂停按钮停的是计时层,累加层和渲染层保留最后一帧的状态不动。
还有一层容易漏掉的:视图生命周期。主界面是「Tab + view section」结构,renderAll() 里硬编码了 18 个 view 的显隐:
// js/app.js - renderAll()(既有代码,本轮零改动,L143-163)
$('#view-products').style.display = view === 'products' ? 'block' : 'none';
$('#view-cart').style.display = view === 'cart' ? 'block' : 'none';
// ……中间 14 行同构……
$('#view-review').style.display = view === 'review' ? 'block' : 'none';
document.querySelectorAll('.tab').forEach(function (t) {
t.classList.toggle('active', t.getAttribute('data-view') === view);
});
注意这份白名单里没有 view-perf。这带来两个后果,一个麻烦一个便宜:麻烦是切到 perf 时没人把 view-perf 显示出来、切走时也没人隐藏它;便宜是 tab 高亮那行用的是 querySelectorAll 动态匹配 data-view,只要新 Tab 带 data-view="perf",高亮会自动生效,不用我碰 app.js。这两个细节,决定了 5.2 节那个包装方案的全部形状。
4. 工程怎么搭:把动态仪表从业务代码里彻底摘出去
先看这轮动过的文件,职责分得很干净:
entry/src/main/resources/rawfile/www/
├── index.html # 1499 行:L48 加 perf Tab、L1359 加 section#view-perf、L1432 引脚本
├── css/
│ └── mall.css # 951 行:末尾追加 pfp- 前缀样式,既有规则一个没动
├── js/
│ ├── app.js # 2932 行:正文零改动(保住文章里的源码锚点)
│ ├── perf-panel.js # 新增 663 行:主界面动态仪表,自管视图显隐
│ ├── perf-bench.js # 改造 702 行:独立页基准引擎 + 自动重跑
│ └── ...(catalog/cart/web/harmony/adapter 等,本轮全未动)
└── perf.html # 改造 272 行:独立报告页,控制条 + 折线 + 折叠快照
这次整理最关键的变化,是把「一个能看的功能」变成「一个能自己活、又不碰主逻辑的功能」。三条边界:
- 主逻辑不依赖仪表:
app.js不知道PerfPanel存在,也不知道有view-perf;反过来仪表单方面包装app.js暴露的setView。 - 仪表不依赖真机能力:全程只有
performance.now()、localStorage、DOM、setInterval,Web 和 ArkWeb 都能真跑,不存在needsDevice,也不存在「Web 端伪造成功」。 - 两套实现共享同一份数据:
makeState()优先读mall:mall_biz_v1里用户真实操作过的业务数据,读不到才退回与app.js:1981 bizSeed()同构的种子,两种策略拿到的是同一个对象。
最小接入其实就三处,全在 index.html:
<!-- index.html - Tab(L48) -->
<button class="tab" data-view="perf" onclick="MallApp.setView('perf')">性能优化</button>
<!-- index.html - view 容器(L1359,节选) -->
<section id="view-perf" class="view" style="display:none"> ... </section>
<!-- index.html - 脚本引入(L1432,注意在 app.js 之后) -->
<script src="js/app.js"></script>
<script src="js/perf-panel.js"></script>
perf-panel.js 加载时机有个讲究:它要包装 MallApp.setView,所以必须排在 app.js 之后。app.js 是 IIFE,末尾同步执行 global.MallApp = MallApp(L2925),DOMContentLoaded 才 init();因此我的脚本加载时 MallApp 一定已经挂上,包装一定拿得到。
通道协议沿用项目里所有能力页的统一回包,手动操作的每个按钮都返回同一结构:
{
"ok": true,
"code": 0,
"data": {
"seq": 1,
"strategy": "naive",
"changeEvery": 33,
"changed": false,
"counters": { "stringify": 1, "writes": 1, "bytes": 1873, "renders": 1, "chars": 1642, "lookups": 14 },
"elapsedMs": 0.06
},
"message": "单步完成 · 原始实现"
}
这里有一个容易被忽略的窗口期:setInterval 在切到别的 Tab 时不会自己停。如果只做「进入 perf 启动」,用户切去商品页挑东西,仪表还在后台每 110ms 跑一批 14 次 DOM 查询,白白占 CPU。所以包装函数里必须同时处理「进入」和「离开」,这个在 5.4 节展开。
5. 把代码讲透
5.1 一个 tick 到底跑了什么:计时器只是发令枪
接收侧最容易写错的是把「帧」和「测量」混成一件事。我的 runTick 里,一个 tick 就是一小批真实交互,两套实现各跑一遍:
// js/perf-panel.js - runTick()(L399,节选)
function runTick() {
ensureStates();
var cfg = SPEEDS[live.speed]; // mid: 每 380ms, ops=4
var every = getEvery(); // 状态变化间隔,默认 33
var liveEl = el('pfp-live-list'); // innerHTML 真的写到这个节点
var nMs = 0, oMs = 0, i, rn, ro;
for (i = 0; i < cfg.ops; i++) {
seq++;
rn = doAction(states.naive, 'naive', seq, every, liveEl);
ro = doAction(states.optimized, 'optimized', seq, every, liveEl);
accum('naive', rn);
accum('optimized', ro);
nMs += rn.ms; oMs += ro.ms;
}
live.ticks++;
live.totalActions += cfg.ops;
samples.push({ n: r2(nMs), o: r2(oMs) });
if (samples.length > SPARK_MAX) samples.shift();
renderAll();
return lastFrame;
}
三个细节值得单独说:第一,doAction 里的 JSON.stringify(biz)、liveEl.innerHTML = html、el(LOOKUP_IDS[i]) 都是真调用,c.stringify++ / c.renders++ / c.lookups++ 都跟在真实语句后面,不是先写死一个数字再补动画。第二,LOOKUP_IDS 是本页真实存在的 14 个 id(pfp-status、pfp-hero、pfp-spark……),查的是真节点,不是拿一个字符串数组空转。第三,两套实现用同一个 seq,所以「状态变化间隔」这个负载对它们是同一批交互,口径才对得上。
一个反直觉陷阱:优化实现的缓存跨 tick 保持,不每帧重建。一开始我沿用旧基准里「每轮重建缓存」的写法,结果折线上优化实现那一根始终贴着 0、看不出任何变化。后来才想明白——真实应用里的脏标记缓存本来就是长寿命的,跨帧复用才是它的常态;每帧清一次缓存,等于模拟了一个「每次都重新登录」的假场景。缓存的生命周期要跟真实使用场景对齐,不能为了让图表好看去重置它。
降级说明:performance.now() 不存在时 now() 退回 Date.now(),毫秒精度从亚毫秒掉到毫秒级,折线会变钝,但打点计数完全不受影响——这也是为什么详情页里我坚持「次数比毫秒可信」。
5.2 包装 setView:为什么不改 app.js 一个字符
这是这轮最想留下来的一节。前面几篇文章引用了大量 app.js 的真实行号:bizSeed() 在 1981、bizSave() 在 2015、bizRenderAll() 在 2035、bizSetText() 在 2075。只要在 app.js 中间插一行,后面所有行号整体漂移,已交付文章里的源码锚点全部作废。
不改正文,又要接进主界面,办法是单方面包装它暴露的方法:
// js/perf-panel.js - wrapSetView()(L626,节选)
function wrapSetView() {
var app = global.MallApp;
if (!app || typeof app.setView !== 'function' || app.__perfWrapped) return;
var orig = app.setView;
app.setView = function (v) {
orig(v); // 原逻辑照跑:renderAll 处理它认识的那 18 个 view,tab 高亮自动匹配 data-view
var sec = el('view-perf');
if (sec) sec.style.display = (v === 'perf') ? 'block' : 'none';
if (v === 'perf') { if (!entered) boot(); else if (!live.running) start(); }
else if (live.running) stop(); // 切走自动暂停
};
app.__perfWrapped = true;
}
三个细节值得单独说:第一,orig(v) 必须照常调用,它内部的 renderAll() 会把 18 个既有 view 全部按 view 值显隐——当 v === 'perf' 时这 18 个全变 none,正好帮我把其他页面收干净,我只需要额外把 view-perf 打开。第二,tab 高亮不用我管,renderAll() 末尾那句 querySelectorAll('.tab') 是遍历所有 Tab 比 data-view,我的 Tab 带 data-view="perf" 就会自动点亮、其他自动熄灭。第三,__perfWrapped 是幂等哨兵,防止脚本被重复加载时套两层包装,那样一次点击会跑两遍 orig。
一个反直觉陷阱:包装发生在脚本加载时,而 app.js 的 init() 可能还没跑(DOMContentLoaded 才触发)。我一开始担心这时包装会不会太早,实际不会——global.MallApp = MallApp 是 IIFE 末尾同步执行的,setView 早就挂在对象上了;包装改的是对象属性的引用,init() 里不重新赋值 setView,所以后面怎么初始化都不影响。真正在 mock 里翻车的是另一回事,放在第 6 节讲。
降级说明:万一 MallApp 不存在(比如把 perf-panel.js 单独拿去某个静态页用),wrapSetView 直接 return,PerfPanel 的手动方法仍然可用,只是没有自动的视图显隐。页面不会因此报错。
5.3 折线怎么「向左滚」:一个 40 点的数组,不生成任何假数据
折线最容易被做成假动画:随便造 40 个正弦点,每帧平移一下,看着也很「动态」。我没那么做,renderSpark 的点全部来自 samples,而 samples 是 runTick 每帧 push 真实耗时、shift 最老一帧得来的:
// js/perf-panel.js - renderSpark()(L333,节选)
function points(key) {
var arr = [];
for (var i = 0; i < n; i++) {
var x = pad + (W - pad * 2) * (i / (SPARK_MAX - 1));
var y = pad + (H - pad * 2) * (1 - samples[i][key] / max);
arr.push(r2(x) + ',' + r2(y));
}
return arr.join(' ');
}
h += '<svg class="pfp-svg" viewBox="0 0 320 96" preserveAspectRatio="none">' +
'<polyline points="' + points('n') + '" class="pfp-line-n" />' +
'<polyline points="' + points('o') + '" class="pfp-line-o" />' +
'</svg>';
三个细节值得单独说:第一,x 坐标固定按 i / (SPARK_MAX - 1) 铺满整个宽度,点数不足 40 时曲线只占左边一段,随着帧数增加慢慢长满——这是「采样在累积」的真实视觉,不是预填充。第二,max 是当批采样的真实峰值,每帧重算,所以纵轴会跟着抖,页面把峰值 fmt(max) 明写在图例里。第三,preserveAspectRatio="none" 配 vector-effect: non-scaling-stroke,SVG 被 CSS 拉宽时线宽不跟着变粗,否则窄屏上线会糊成一坨。
一个反直觉陷阱:samples.length < 2 时我直接渲染占位文案,不去凑一个点画折线。因为单个点的 <polyline> 在部分 WebView 里会渲染成一个小方块,看起来像「数据坏了」。宁可写「开始运行后按真实耗时画折线」,也不画一个会误导人的图形。
降级说明:SVG 在 ArkWeb 里可用;若退到极老的环境不支持 <polyline>,折线区会空白,但大数字、条形、详细表都是纯 DOM,功能不受影响。
5.4 切页自动暂停:把 setInterval 空转的账算清楚
这一节讲的是生命周期,不是算法。三档速度定义在文件头:
// js/perf-panel.js - SPEEDS(L32)
var SPEEDS = {
slow: { interval: 900, ops: 1 },
mid: { interval: 380, ops: 4 },
fast: { interval: 110, ops: 12 }
};
快档每 110ms 跑 12 次交互 × 2 套实现 × 14 次 DOM 查询,也就是每秒约 3000 次 getElementById。用户切去商品页之后这些调用一点意义都没有。所以 stop() 不只是把状态灯变灰:
// js/perf-panel.js - stop()(L441,节选)
function stop() {
if (!live.running) return;
live.running = false;
if (live.timer) { global.clearInterval(live.timer); live.timer = null; }
log('⏸ 已暂停 · 数字停住,共 ' + live.ticks + ' 个 tick');
renderStatus();
renderAll();
}
三个细节值得单独说:第一,clearInterval 后把 live.timer 置 null,避免重复 stop 时对已失效的 id 再清一次。第二,暂停只停计时层,tally / samples / 最后一帧 DOM 全部保留,所以「暂停」是冻结现场而不是清空,用户能定住某一刻的数字慢慢看。第三,切回 perf 会自动恢复(包装函数里 else if (!live.running) start()),不用再点一次开始。
一个反直觉陷阱:调速时不能直接改 live.speed 就完事——已经跑起来的 setInterval 用的是旧间隔。所以 setSpeed 里要先 clearInterval 再按新档 setInterval,否则「点了快档但还要等完当前这一拍才生效」,用户会觉得按钮没反应:
// js/perf-panel.js - setSpeed()(L455,节选)
if (live.running) {
if (live.timer) global.clearInterval(live.timer);
live.timer = global.setInterval(runTick, SPEEDS[k].interval);
}
降级说明:页面隐藏(切后台窗口)时我不额外监听 visibilitychange——主界面的 Tab 切换已经覆盖了主要场景,再加一层监听会和多窗口那几页的焦点逻辑打架,收益不大,先不做,边界写进 Debug 区。
5.5 独立页也动起来:一份基准,两种驱动
主界面是「小步快跑」,独立报告页是「整页重算」,两者用的是同一个 run(),但驱动节奏完全不同:
// js/perf-bench.js - AUTO_SPEEDS 与 autoTick(L32 / L564,节选)
var AUTO_SPEEDS = { slow: 2000, mid: 900, fast: 350 };
function autoTick() {
var res = run(lastOps()); // 完整基准:3 轮预热 + 7 轮取中位数
render(res); // 摘要卡 / 9 项表 / 条形图整页刷新
autoState.runs++;
autoState.frames.push({ n: res.groups[0].naiveMs, o: res.groups[0].optMs });
if (autoState.frames.length > AUTO_SPARK_MAX) autoState.frames.shift();
renderAutoSpark();
renderAutoStatus();
return res;
}
三个细节值得单独说:第一,独立页每一帧是「完整基准」(3 轮预热 + 7 轮采样 × 3 组 × 400 次交互),比主界面一个 tick 重得多,所以默认间隔给到 900ms,快档也只到 350ms,不能照抄主界面的 110ms。第二,静态产物表只画一次:
// js/perf-bench.js - render()(L474)
if (!staticRendered) { setHtml('perf-static-body', sh); staticRendered = true; }
那 6 行字节数本来就是固定快照,每帧重拼一遍纯属浪费,staticRendered 一个布尔就省掉了。第三,日志降噪:自动重跑每 5 帧才写一条汇总日志,否则 60 条上限的日志窗口几秒就被刷满,反而看不清手动操作留下的记录。
一个反直觉陷阱:自动重跑时「次数」那一列是不动的、「毫秒」那一列一直在变。有那么一瞬间我想把次数也做点浮动让它显得更「活」,立刻反应过来那是造假——调用次数由代码路径决定,本来就该确定。所以在页面 notice 里我把这句话写死了:「次数是确定的,毫秒会真实抖动,所以你会看到耗时那一列一直在变、次数那一列不动」。让用户知道哪一列该静、哪一列该动,比让所有数字一起蹦跶诚实得多。
降级说明:setInterval 不可用(极少见)时,独立页仍可手动点「手动重跑一次」,runAndRender 不依赖计时器。
6. 我踩过的坑(每一条都有真实报错)
这一节可能是全文最值钱的部分。以下坑全部来自这次开发的真实报错和排查记录,和前两篇(存储键漂移、差值符号、签名时间戳、批量删除拦截)没有一条重复。
坑 1:用户一句「太假了」,把我 6 行硬编码常量全打回。 现象:性能页打开后所有数字静止不动,854714、665676、29007 这些值从头到尾不变。排查时我第一反应是「是不是数据没刷新」,去翻 render() 才发现根本没有刷新这回事——STATIC_ROWS 是源码常量,页面生命周期里只被拼表一次。这不是 bug,是设计就错了:我把「一次实测快照」做成了「一屏永远不动的报表」。
# 返工前 perf.html 首屏(示意,值来自硬编码常量)
signed HAP 体积 854714 B → 665676 B (永不变化)
unsigned HAP 体积 825707 B → 635026 B (永不变化)
签名块增加 29007 B → 30650 B (永不变化)
修复:主界面整块删掉静态产物基线容器和 STATIC_ROWS,改成 setInterval 驱动;独立页把这 6 行收进 <details> 默认折叠,标题写明「固定不变」。用户说「假」的时候,多半不是怀疑数字造假,而是看穿了页面没有在跑。
坑 2:mock 里 Catalog 是空壳,renderAll 直接崩。 现象:第一次跑 DOM mock 校验,加载 app.js + perf-panel.js 后调 setView('perf'),立刻抛:
TypeError: Catalog.getCategories is not a function
at renderCategories (app.js:70:44)
at renderAll (app.js:136:5)
at setView (app.js:223:5)
at app.setView (perf-panel.js:631:7)
一开始以为是包装写坏了,盯着 wrapSetView 看了半天。后来才反应过来:我包装的 setView 会照常调 orig(v),而 orig 里的 renderAll 要跑完整的商品/购物车/分类渲染,mock 给的三个全局是 {},当然没有 getCategories。这恰恰反过来证明包装是对的——它真的把原始逻辑完整跑了一遍。修复是把 stub 补齐:
// 校验脚本 - 补齐 renderAll 会调到的方法
g.Catalog = { getCategories: () => [], getProducts: () => [] };
g.Cart = { count: () => 0, list: () => [],
calculate: () => ({ subtotalFen: 0, discountFen: 0, payableFen: 0 }) };
g.Platform = { kind: 'web', storage: { get: () => Promise.resolve(''),
set: () => Promise.resolve(true) } };
包装别人家的函数前,先弄清楚那个函数会连带跑什么;mock 的报错经常是在替你验证「原逻辑确实被执行了」。
坑 3:readyState 设成 complete,init() 提前跑炸在 installBridgeLogger。 现象:第二版校验脚本里主界面 mock 用了 document.readyState = 'complete',app.js 加载完立即执行 init(),抛:
TypeError: Cannot read properties of undefined (reading 'write')
at installBridgeLogger (app.js:528:48)
at init (app.js:2734:5)
at app.js:2930:5
init() 里会给 Platform.file 之类的方法包一层日志代理,f.write 读的是 undefined。我不需要测 init,只想拿到 MallApp 对象和验证包装。修复是把 readyState 改回 'loading',让 app.js 把 init 挂到 DOMContentLoaded 上、校验里不触发它;而 perf-panel 是懒 boot(靠 setView 触发),完全不依赖 DOMContentLoaded。
const { g, mkEl, timers } = mkEnv('loading'); // 改回 loading,不触发 init
测试环境的就绪状态会决定被测代码走哪条分支;别为了少写两行 stub 去改它,那是在改被测对象的行为。
坑 4:onclick 校验把 document.getElementById 当成了未导出的方法。 现象:静态校验报 onclick 引用未导出: 未知命名空间 document.getElementById。排查发现是正则 onclick="([A-Za-z]+)\.([A-Za-z0-9_]+)\( 太宽,把内联里一处原生 DOM 调用也收进来了。这是校验脚本自己的假失败,不是页面问题。修复是给命名空间加白名单,其他内联表达式单独统计、不计失败:
const otherNs = allOnclicks.filter(x => x[1] !== 'MallApp' && x[1] !== 'PerfPanel');
const onclicks = allOnclicks.filter(x => x[1] === 'MallApp' || x[1] === 'PerfPanel');
校验脚本报错时,先确认是产品代码错了还是校验器错了;否则会为了修一个不存在的 bug 去改对的代码。
坑 5:沙箱里 rm 直接不认识解释器。 现象:想删临时校验脚本,rm -f 报:
/data/storage/el1/bundle/electron/.../safe-bin/rm: /bin/bash: bad interpreter: No such file or directory
Exit Code: 126
鸿蒙沙箱下这个 rm 是个 shim,头部写死了 /bin/bash,而环境里没有。绕开它没别的巧办法,用 Node 的 fs 删:
node -e "require('fs').unlinkSync('/storage/Users/currentUser/WorkBuddy/2026-11-21-17-25-42/_verify_perf2.js')"
在这套环境里,文件操作优先走 Node 的 fs,别指望 POSIX 命令的 shim 一定可用。
坑 6:差一点用随机数做「动态」,把测量改成动画。 这不是报错,是这轮最该记下的一次自我拦住。改到折线时,最省事的写法是造 40 个 Math.random() 点每帧平移,用户看到的一样是「会动的曲线」。我甚至已经想好注释怎么写。停下来是因为它经不起一句追问:这根线代表什么?答不上来。最终 renderSpark 只从 samples 取数,而 samples 每个元素都是 runTick 里 performance.now() 现测后 push 进来的。
// 返工中否掉的写法(没有进仓库)
samples.push({ n: Math.random() * 2, o: Math.random() * 2 }); // 不要用
// 仓库里的写法:js/perf-panel.js - runTick()(L399)
samples.push({ n: r2(nMs), o: r2(oMs) }); // nMs/oMs 是本帧两套实现的真实耗时累加
「动态」是个观感词,不是实现方案;一旦用假数据去满足它,前面所有关于「真实」的口径全部作废。
坑 7:setInterval 切页不停,后台空转。 现象:mock 里驱动 15 帧后调 MallApp.setView('products'),检查 getLive().running 仍是 true——第一版包装只处理了「进入 perf 启动」,没处理「离开 perf 暂停」。快档下这意味着每秒几千次无效 DOM 查询。修复是在包装的 else 分支补 stop(),并加断言:
// js/perf-panel.js - wrapSetView()(L626)
if (v === 'perf') { if (!entered) boot(); else if (!live.running) start(); }
else if (live.running) stop();
[9] 暂停/切走自动暂停/切回恢复/重置 全部通过
计时器是有生命周期的:谁启动,谁就得负责在视图离开时关掉它,否则优化页自己就是最大的性能问题。
坑 8:独立页每帧重拼静态表,白干 6 行 DOM。 现象:给 perf-bench.js 加上自动重跑后,每帧 render() 都会重新拼一次那 6 行构建快照表,可它们从头到尾一个字节都不变。这是纯粹的浪费,还让「固定不变」的快照在视觉上跟着刷新,更容易让人误会它在动态测量。修复是 staticRendered 一次性标志(见 5.5 节 L474)。能跑不等于跑得对:把不变的东西从高频重绘里摘出去,本来就是这轮该做的事。
7. 现在怎么用:从一屏死表到一条判断
构建和验证还是这套工程的老命令:
export DEVECO_SDK_HOME=/storage/Users/currentUser/WorkBuddy/2026-11-21-17-24-54/harmony-sdk-home
node /data/service/hnp/hmos-clt.org/hmos-clt_1.0.0/hvigor/bin/hvigorw.js \
--mode module -p product=default assembleHap --no-daemon
> hvigor Finished :entry:default@SignHap... after 623 ms
> hvigor Finished :entry:assembleHap... after 1 ms
> hvigor BUILD SUCCESSFUL in 11 s 374 ms
33 tasks in total: 20 executed, 13 up-to-date
产物 entry-default-signed.hap 912168 字节,解包校验五个文件都在:perf.html 19575 B、perf-bench.js 32962 B、perf-panel.js 29515 B、index.html 105445 B、mall.css 50987 B;module.json 权限仍是 4 项(INTERNET / GET_NETWORK_INFO / READ_CALENDAR / WRITE_CALENDAR),没有为这轮新增任何受限权限。构建日志里只有提示性 WARN(audio 的 syscap not on all devices、'write' has been deprecated、Function may throw exceptions、getContext has been deprecated),没有 ERROR。
回归自检跑了两轮 DOM mock:第一轮 27 项通过(id 227 个无重复、19 个 Tab 与 19 个 section 一一对齐、209 处 onclick 全部导出、进入 perf 自动运行、驱动 12 帧 stringify 48→2 / 查询 672→14);第二轮 31 项通过(主界面驱动 15 帧 stringify 60→2 / 查询 840→14,独立页自动重跑 12 帧、折线 12 个采样、9 项表 / 折叠快照 / 状态灯 / 暂停恢复 / 调速全通过)。本地 127.0.0.1:8099 三个页面都返回 200。想看效果,打开 index.html 切「性能优化」Tab 就是活的,Debug 区那个按钮能跳到独立页。
免得读者踩到同一堵墙,硬限制清单照旧列清楚:
- 耗时是 JS 层计时,不是真机帧率、不是首帧、不是 ArkTS 侧耗时;跨机器跨浏览器不可直接比较。
- 优化实现是
perf-panel.js/perf-bench.js里的实验代码,没有替换app.js的bizSave()/bizRenderAll()/bizSetText(),业务代码保持原样,app.js本轮正文零改动。 - 查询缓存组耗时可能反增:缓存要付
hasOwnProperty/ 指纹比对成本,原生getElementById太快,次数下降不等于提速;折线照实画,不粉饰。 - 独立页折叠的构建产物是 2026-11-22 一次实测快照,固定不变、不参与动态对比;签名带时间戳,重复构建会浮动几字节。
- 状态变化间隔(默认 33)是设定的负载比例,只用来对照两套实现的相对成本,不代表真实用户操作分布。
- 本工程
.p7b是 debug profile,.app能打出来但不能真的上架应用市场;上架要换 release profile 与发布证书。 - 页面隐藏(切后台窗口)时只靠 Tab 切换暂停,没有额外监听
visibilitychange;极小概率下后台仍会跑帧。
一开始我把它当成一份要交的报表,比的是谁把数字摆得更全、口径写得更严;被那句「太假了」打回来之后才明白,性能这件事的说服力根本不在数字全不全,而在它是不是当着你的面跑出来的。一张写满真实数字的静态表,和一个每 380ms 真跑一帧、数字自己往上跳的仪表,前者需要你相信我,后者你自己就能看见。至于「一个字符都不改 app.js 也能接进主界面」,那更像是顺手捡到的便宜:主逻辑越是不被仪表打扰,这份仪表就越能一直留在项目里。
更多推荐

所有评论(0)