Flex-wrap 折行失效通常因父容器缺 min-width: 0 或子项设 white-space: nowrap；需同时设置 display: flex、flex-wrap: wrap、min-width: 0，子项用 flex: 0 1 100px 并确保 box-sizing: border-box。
Flex-wrap 折行失效的典型表现
工具栏元素挤在一行、溢出容器右侧、滚动条意外出现，或者明明写了 flex-wrap: wrap 却完全不折行——这通常不是 CSS 写错了，而是父容器或子项存在隐性约束。最常见的是父容器设了固定宽度（比如 width: 600px）但没配 min-width: 0，导致 Flex 子项按内容撑开后无法触发换行；另一个高频原因是子项用了 white-space: nowrap（尤其按钮内含图标+文字时被框架默认加上），强行阻止自身收缩。
必须设置的三个关键 CSS 属性
只写 flex-wrap: wrap 不够。要让折行真正响应视口变化，需组合控制：
-
display: flex和flex-wrap: wrap必须同时作用于工具栏容器（如.toolbar） - 每个工具栏子项（如
.toolbar-btn）需明确设flex-shrink: 1（默认是 1，但某些 UI 库会重置为 0） - 容器本身建议加
min-width: 0，防止子项 flex 基准计算异常（尤其当容器嵌套在 Grid 或其他 Flex 中时）
避免媒体查询硬编码断点
用 @media 配 max-width 手动切布局，容易漏掉平板横屏、折叠屏等中间尺寸。更可靠的做法是让 Flex 自动响应：给子项设 flex-basis: fit-content 或具体值（如 flex-basis: 120px），再配合 flex-grow: 0 防止拉伸。这样当总宽度超容器时，Flex 引擎自然触发折行，无需 JS 或额外断点。
示例关键片段：
立即学习“前端免费学习笔记（深入）”；
.toolbar {
display: flex;
flex-wrap: wrap;
min-width: 0;
}
.toolbar-btn {
flex: 0 1 100px; /* grow: 0, shrink: 1, basis: 100px */
margin: 4px;
}编辑器内实时预览的兼容陷阱
在 Monaco、CodeMirror 等编辑器中嵌入工具栏时，常因编辑器容器使用 position: absolute 或 transform 导致 Flex 容器的百分比宽度计算异常。此时折行可能只在缩放后才触发，或完全卡死。解决方法是：确保工具栏父容器有明确的 width（哪怕 width: 100%），且该容器不能是 transform 的直接子元素；若必须用 transform，改用 contain: layout 强制隔离渲染上下文。
另外，某些编辑器主题 CSS 会全局重置 box-sizing，导致 padding 和 border 影响 flex-basis 计算——务必检查子项是否加了 box-sizing: border-box。
折行逻辑本身很简单，难的是它依赖整条渲染链路的宽度推导不出错。只要父容器宽度可预测、子项不抗拒收缩、编辑器宿主不干扰盒模型，flex-wrap 就能安静地完成所有工作。
