跳转至

为「固定高度 × 会换行的内容」立机器闸 —— 并在建闸时第四次犯了同类错

为什么立闸

ISSUE-0197(界面塌掉)的根因不是某一行写错,是一类结构性错误:

固定高度的容器 + 会换行/可伸缩的内容 = 窗口够窄就一定溢出。

它在那次事故里同时出现在两处(我新引入的视图行、以及既有的工具条), 而我只读代码判断不出来 —— 布局问题要么真实渲染,要么有静态判据。 扩展页面是 chrome-extension://,在浏览器预览里跑不起来(实测是静态快照、脚本不执行), 所以这里选静态判据。

scripts/scan-fixed-height-flex.py:height: <数字> 且同一元素上有 direction={{ xs: 'column' }} 或 flexWrap: 'wrap' ⇒ 拦。 豁免要带非空理由,且「现在看起来没问题」不算 —— 事故那两处当时看起来也没问题。

🔴 建闸时第四次犯了同类错

第一版判据用「height: 附近 ±12 行」找换行证据,结果:

  • Chip 的 height: 24 撞上父容器的 flexWrap ⇒ 误报
  • 我自己写的注释文本「原来是固定 height: 54」也被当成代码 ⇒ 误报

在一个治布局问题的工具上,又犯了「判据在量别的东西」。 本仓第四次 (predicate-guard 三次、scan:unbounded-query 一次、这次)。

修法: - 往上找最近的 <Xxx 定位到同一个 JSX 元素,不用固定行数窗口 - 注释行直接跳过 - Chip / Button / IconButton / Avatar / Switch / … 这类小控件的固定高度是正常的,跳过

⚠️ 还有一个更隐蔽的:自测的期望值本身写错了

第一次跑双向自测,输出是「命中行 5/15/49」,而我手数的期望是「6/16/50」—— 差一行,于是判据看起来「抓不住事故本身」。差点据此认为闸是废的、回头改判据。

真相是 height: 在 sx={{ p: 1, height: 54 }} 那一行(第 5 行),我把 > 那行数进去了。

⇒ 固化的自测改成按「哪个探针函数被拦」断言,不按手数的行号。 判据的期望值也是判据的一部分,它错了一样会把人带偏。

逐行检查的结果(顺带修的)

商家列表页自上而下四行,逐个过了一遍:

行 结构 结论
标题行 Stack row,右侧 portal 挂模式开关 + 一句说明 🔴 有隐患:没有 flexWrap,而我加的说明最长 30 字,窄窗口会把标题挤扁 —— ISSUE-0197 同款形态。已加 flexWrap + 长说明窄屏收起(问号里有一份,不会丢)
视图行 height: 48 + tabs(flexGrow:1) + 右侧 minWidth:{md:300} ✅ chips 移出后回到改造前状态;tabs 是 scrollable,会横向滚不会撑破
再筛行 flexWrap: 'wrap',父容器无固定高度 ✅ 折行只撑高,安全
工具条 direction={{xs:'column'}} + minHeight: 54 ✅ ISSUE-0197 已修