为「固定高度 × 会换行的内容」立机器闸 —— 并在建闸时第四次犯了同类错
为什么立闸¶
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 已修 |