跳到正文
  1. How-to
  2. 在真实项目里
  3. 嫌它慢:用数字证明变快了

嫌它慢:用数字证明变快了

一句话开口先给一个测出来的数字。它测、改、再测,拿出你能信的前后对比。

一次诊断加修复,一到两次对话适用:觉得某个地方慢,想让 AI 找到真原因,拿出可信的前后对比完整教程第 6 步:验证和交付

先照抄一个

最短的写法
/pstack:poteto-mode 在这份测试数据上,启动要 1.8 秒。trace 一下,修掉测量出来的原因,给我看前后对比。
  • 「这份测试数据上 1.8 秒」:一个测出来的数字。「感觉有点卡」它没法比。
  • 「trace 一下」:trace 就是把程序每一步花了多少时间录下来。
  • 「测量出来的原因」:它要修 trace 里看到的那个,不修它猜的那个。
性能问题只认测出来的数字。
  1. 1测基线p50 约 900ms
  2. 2看时间花在哪trace 一下
  3. 3修测出来的原因不修猜的那个
  4. 4同样的数据再测p50 低于 200ms,返回的一样

没变快就撤回,再来一轮

图示前后两个数字用同样的数据、交替各跑几次,比的是中位数。

会员站的例子

一个跑在 Cloudflare Workers 上的会员站,数据在 D1 里。会员列表接口越来越慢。

Workers 加 D1 的例子
/pstack:poteto-mode 会员列表接口 /api/members 在本地 wrangler dev、导入 5000 条测试会员时,p50 大约 900ms。
先测一份基线,告诉我时间花在哪。修掉测量出来的原因。
修好的标准:同样的数据,p50 低于 200ms,返回的会员条数和内容和修之前完全一样。
两边交替各跑 7 次,给我中位数和范围,再跑一次 /pstack:benchmark-checklist。
  • 「返回的条数和内容完全一样」:改快了但少返回了数据,等于没修。
  • 「交替各跑 7 次」:只跑一次的数字,随时可能是偶然。
  • 5000 条数据:一个你能重现的场景。数据太少,问题可能根本不出现。

发出去以后看哪里

开头:基线数字。 它没测就说「这样改会更快」,打断它。

最后:四样东西。 基线数字、修完的数字、差多少、数据文件在哪。测不出结论的,它会写出来,不算通过。

数字好得不像真的:/pstack:benchmark-checklist

复制下面这段
/pstack:benchmark-checklist 这个 40% 的提速写进 PR 说明之前,先检查一遍

性能剧本会自动跑它。别人给的数字,你也可以手动查。七个问题,每个都要拿真实运行当证据:

  1. 为什么不是快一倍? 说出卡住这个数字的瓶颈。
  2. 两边都按正式环境配好了吗? 不能一边调试版、一边正式版。
  3. 超过物理极限了吗? 比磁盘还快,说明量的是别的东西。
  4. 有没有报错? 被拒绝的请求往往很快,要数出来。
  5. 能重现吗? 两边交替各跑至少 5 次,报中位数和范围。
  6. 对用户有意义吗? 只占 1% 耗时的函数,最多省 1%。
  7. 被计时的活真做了吗? 没人等的 promise 跑得飞快。

结论只有四种:更快、更慢、没有可测量的差别、无法下结论。

只想知道慢在哪,先别修

只要诊断
/pstack:poteto-mode 这是启动慢的时候录的 cpuprofile。告诉我时间花在哪、是哪几行代码。先别修。
  • 手上有录好的文件(cpuprofile、trace、heap snapshot):它只读这份文件,找出最慢的那几行。
  • 问题正在发生(内存一直涨、空闲时 CPU 也在转、界面闪):它对运行中的程序录数据。再做个小实验,确认原因。

两种都只交回带出处的诊断,你再决定怎么修。

想把一个数字一直往下压

打包体积、首屏时间这种要持续优化的数字,用 Hillclimb。给它三样:指标、目标、至少试几轮。

Hillclimb
/pstack:poteto-mode hillclimb 侧边栏首次打开时间。目标:比基线快至少 50%,并且至少试 10 轮。每轮记一行决策日志。
  • 「至少试 10 轮」:防止第一轮运气好达标,马上收工。
  • 每轮只改一处,量一次。 变快了就留下、单独提交;没变快就撤回。
  • 每轮记一行。 记在 decision.tsv 里,你能看到每次试了什么。

卡住了?

它没测就说「改成这样会更快」。

回它:「先测。给我基线数字和 trace 文件路径,再说改哪里。」

提升大得离谱,我不太信。

跑 /pstack:benchmark-checklist,特别看第 3 题和第 7 题。这对应 explain-the-number,意思是:说清是什么卡住了这个数字,并排除它量错了东西。这是 pstack 认识的一条原则名。

它只跑了一次就下结论。

回它:「两边交替各跑至少 5 次,报中位数和范围。差距比两次运行之间的波动还小,就是没有差别。」

Hillclimb 卡在一个数上不动,它就想停。

它应该先换思路,不能放宽目标来宣布完成。真卡死了,它应该把情况告诉你。

本站是 pstack 的非官方入门教程,不是官方文档;pstack 由 poteto 开发,命令和行为以官方仓库为准。教程原始源码见 GitHub。

由 airali部署,基于小小东的 MIT 授权教程改编。