overflow: auto 不会自动显示滚动条，必须满足内容高度超过显式设定的容器高度（如 max-height）这一前提；常见失效原因包括未设 height/max-height、Flex 子项未设 min-height: 0、macOS 隐藏滚动条机制等。
overflow: auto 不是“设了就出滚动条”的开关，它只在内容真正超出容器限定尺寸时才触发——而这个“限定尺寸”必须显式给出，否则浏览器根本不知道什么叫“超出”。
为什么加了 overflow: auto 却没滚动条？
最常见原因是容器没有明确的高度或宽度约束：
-
height或max-height缺失 → 容器高度自适应，永远不溢出 - 只设
min-height→ 它不构成溢出判定边界，overflow: auto无视它 - 父容器是
display: flex且未设align-items: flex-start或未清除拉伸行为 → 子项被撑开，实际高度未受限 - 子元素用了
position: absolute→ 脱离文档流，溢出计算时被忽略
max-height 比 height 更适合大多数场景
固定 height 容易导致内容少时留白、内容多时截断；max-height 让容器按需伸缩，只在必要时滚动：
- 用
max-height: 400px或max-height: 60vh替代height: 400px - 配合
overflow-y: auto（比overflow: auto语义更清晰） - 加
overflow-x: hidden防止意外横向滚动（尤其含长单词或white-space: nowrap时）
Flex 子项里 overflow: auto 失效的修复
当容器是 display: flex 的直接子项，默认会拉伸填满可用空间，导致“内容没超出”——此时 overflow: auto 彻底静默：
立即学习“前端免费学习笔记（深入）”；
- 给该子项加
flex: 0 1 auto（等价于flex-grow: 0; flex-shrink: 1; flex-basis: auto） - 或显式设
width: 0; min-width: 0（强制启用收缩，让溢出逻辑生效） - 避免单独设
flex-shrink: 0，它会让子项拒绝压缩，反而撑开父容器
macOS 上“看不到滚动条”不等于“没滚动”
Safari 和 Chrome 在 macOS 下默认隐藏滚动条轨道，仅悬停或滚动时淡入。这不是 bug，是系统级行为：
- 调试时先用滚轮/触控板试试能否滚动，别急着改 CSS
- 若需常显，加 WebKit 专属规则：
.container::-webkit-scrollbar { width: 8px; } - Firefox 用
scrollbar-width: thin控制，但不支持完全自定义样式 - 不要在
上设overflow: auto，会破坏整页滚动
最容易被忽略的一点：滚动是否生效，取决于「内容真实尺寸」和「容器约束尺寸」的实时比较——JS 动态增删内容后，如果容器高度依赖 flex 或 grid 布局自动计算，可能不会重绘溢出状态，得手动触发 layout（比如改个 padding 或 transform）。
