两个分别错了 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()。