两个分别错了 880 与 609 像素的版面
网格和 flex 子项默认是 min-width:auto,意思是「绝不比自己的内容更窄」——于是 900px 的容器里能出现 1509px 的列,整页溢出 270px。另一种是内容根本没被放进容器:正文直接渲染进 <main>,左边贴着 0,右侧空出 880px。两种都靠读四个数字定位,而不是看页面:包围盒的 left 与 width、计算后的 max-width、以及 grid-template-columns。
两个 bug、一个下午,截图看不出来,数字一眼就能看见。
案例一:内容根本没进容器
某个页面把正文直接渲染进 <main>,没有任何包裹层。看起来只是「左对齐、有点空」。在 1600px 视口下实测:
const a = document.querySelector('article').getBoundingClientRect();
// { left: 0, width: 720, right: 720 }
window.innerWidth; // 1600
1600 - 720; // 880px 的空白
本该负责居中的规则写在 .wrap 上——而模板压根没挂这个类。max-width: 720px 工作得好好的;只是外面没有那个用来居中的容器。
补上容器之后:
wrap left 193 width 1200 (上限 1200,在 1600 里居中)
article left 225 width 720
CSS 一个字没改,只是把元素放进了样式表预期的那个父元素里。
这就是布局 bug 的通用形状:规则是对的,结构是错的。 也正因为如此,你在元素上读 max-width 会看到一个完全合理的值,而页面就是坏的。
案例二:拒绝收缩的 1fr
一个两列网格,1fr 200px,容器 900px,其中一格是一条不可断的长 URL。实测:
getComputedStyle(wrap).gridTemplateColumns; // "1509.08px 200px"
document.documentElement.scrollWidth - document.documentElement.clientWidth; // 270
本该是 1fr 的那条轨道,在 900px 的容器里解析成了 1509px,整页溢出 270px。
原因只有一个默认值:网格与 flex 子项是 min-width: auto,意思是「绝不比我的内容更窄」。1fr 是上限,不是承诺。补上护栏:
.grid > * { min-width: 0; }
同一个页面再量一次:
没有护栏:格子宽 1509 整页溢出 270
有护栏: 格子宽 676 整页溢出 0 (内容在格子里滚动:1500)
min-width: 0 让轨道可以收缩;长串在被缩到正确宽度之后怎么处理,交给 overflow-wrap: anywhere(或 overflow-x: auto)。
四个数字
不要眯着眼看,按顺序读这四个:
| # | 读什么 | 它告诉你什么 |
|---|---|---|
| 1 | rect.left、rect.width、innerWidth - rect.right |
有没有空洞,在哪一侧 |
| 2 | getComputedStyle(el).maxWidth |
哪条规则真正生效(以及是不是被别的规则压住了) |
| 3 | getComputedStyle(parent).gridTemplateColumns |
解析后的轨道尺寸——1fr 变成 1509px 的地方 |
| 4 | documentElement.scrollWidth - clientWidth |
页面比视口宽多少像素 |
第 3 个是最常被跳过的那一个。样式表里写的是 1fr 200px,计算值是 1509.08px 200px——能解释溢出的正是后者。
怎么知道它真的修好了
- 每个宽度下
scrollWidth === clientWidth。 一行代码、能跑无头、能抓住所有横向溢出,包括你没想起来看的那种。至少测 390、768、1440。 - 轨道加得起来。
sum(列宽) + gap应当等于容器的内容宽度。对不上,就是某条轨道长过了它该有的份额。 - 空洞是有界的。 居中布局里,
rect.left与innerWidth - rect.right应当接近相等。193 与 207 是居中;0 与 880 是少了容器。 - 改之前和改之后都要数字,并写进提交信息。「修了布局」无法评审;「article left 0 → 225、右侧空白 880 → 655」是可以核对的 diff。
怎么回滚
- 回滚 CSS:留着测量脚本,而不只是旧文件。重跑这四个数字就能确认几何是否回到原样——截图做不到。
- 在大范围选择器上
min-width: 0:可能让原本稳定的列塌掉。限定到该网格的直接子元素,然后三个视口全部重新量一遍。 - 用
overflow: hidden应急:它既藏住症状,也裁掉焦点环和下拉菜单。真要拿它换时间,就留一条备注和后续项——你其实想要的那道护栏是min-width: 0。
相关档案
常见问题
为什么 1fr 会溢出而不是收缩?
因为网格/flex 子项默认 min-width: auto,而 auto 的含义是「不小于我的内容」。1fr 是上限而不是承诺:轨道先满足内容,容器用横向溢出来付账。
该用 min-width: 0 还是 overflow: hidden?
两件事。min-width: 0 让轨道能收缩、内容还能选中;overflow: hidden 是把内容裁掉、把问题藏起来。布局用前者,内容是不可断的长串(比如 URL)时再加 overflow-wrap: anywhere。
不靠眼睛怎么找布局 bug?
读数:getBoundingClientRect() 给 left 与 width,计算后的 max-width 告诉你是哪条规则在打架,grid-template-columns 给出解析后的轨道尺寸。900px 容器里的 1509px 轨道,一旦变成数字就藏不住了。
有没有一条断言能挡住大部分这类问题?
document.documentElement.scrollWidth === clientWidth。任何横向溢出都是布局 bug,在你关心的每个宽度上都测;在无头检查里也就是一行。
来源
本文最后一次核验:2026-11-18 · 两个案例都是 2026-11-18 在真实浏览器里量的:880px 空洞发生在本站某个页面上(修复前),1509px 轨道发生在一个两列测试页上。本页所有数字都来自 getBoundingClientRect() 与 getComputedStyle()。