white-space 是控制文字换行的第一道开关,需设为 normal 才允许折行;中文/长英文需配合 overflow-wrap: break-word 或 word-break: break-all;Flex/Grid 项要加 min-width: 0;兼容旧版 Safari 需同时写 word-wrap 和 overflow-wrap。

文字超出容器不换行,white-space 是第一道开关
默认情况下,white-space: normal 允许浏览器在空格、连字符或中英文交界处折行。如果发现文字完全不换行(哪怕超出了父容器宽度),大概率是误设了 white-space: nowrap 或 white-space: pre。检查 computed styles 时重点看这一项——它会直接覆盖所有其他换行相关属性。
常见误用场景:
• 给按钮或标签加了 white-space: nowrap 防止内部文字被挤碎,结果导致长文本溢出不可见
• 在表格单元格里用了 pre 保留原始空格和换行,却忘了它也禁用自动折行
实操建议:
• 确保需要换行的容器显式设为 white-space: normal(尤其当继承自父级 nowrap 时)
• 若需保留空格但允许折行,用 white-space: pre-wrap
• 仅在绝对需要“一整行不拆”时才用 nowrap,并搭配 overflow: hidden 或 text-overflow: ellipsis
word-break 和 overflow-wrap 解决“中文/长英文不折”的核心问题
word-break 控制是否在单词内部断行;overflow-wrap(旧名 word-wrap)决定是否在无法按词折行时“退而求其次”断开长单词。二者行为有本质区别:前者激进(如 break-all 会把“internationalization”切成 “inter-nation-aliza-tion”),后者保守(只在实在没地方折时才断)。
立即学习“前端免费学习笔记(深入)”;
典型错误现象:
• 中文标题撑爆卡片,因为中文无空格,normal 模式下浏览器认为“整个字符串是一个词”,拒绝折行
• URL 或 Base64 字符串横向溢出,且未启用任何断行策略
实操建议:
• 中文为主内容:优先用 word-break: break-word(注意这是非标准别名,实际应写 overflow-wrap: break-word)
• 中英混排 + 需控断点位置:用 word-break: break-all,但慎用于正文(可读性差)
• 希望尽量保持单词完整、仅对超长串兜底:设 overflow-wrap: break-word 并确保 white-space: normal
Flex/Grid 容器里文字不换行?先查 min-width: auto
在 display: flex 或 display: grid 的子项中,即使写了 white-space: normal 和 overflow-wrap: break-word,文字仍可能不折行——根本原因是 Flex Item 默认有 min-width: auto,会阻止内容收缩,导致容器宁可溢出也不换行。
这不是 CSS 规范缺陷,而是设计使然:Flex 布局优先保障项目尺寸,换行是次要选项。
实操建议:
• 给 flex item 加 min-width: 0(或 width: 0 + min-width: 0)释放收缩能力
• 同时确保该元素有明确宽度限制(如 max-width: 100% 或 flex: 1)
• Grid item 同理,若设了 grid-template-columns: 1fr 却不换行,也要检查 min-width
移动端 Safari 对 overflow-wrap 的兼容性陷阱
iOS 12 及更早版本的 Safari 不支持 overflow-wrap: break-word,只认旧语法 word-wrap: break-word。而现代写法 overflow-wrap 在这些老版本里会被完全忽略,导致长文本彻底不折行——且无任何 warning 提示。
这不是 bug,是标准演进过程中的兼容断层。
实操建议:
• 必须兼容 iOS 12–13 时,同时声明两行:
word-wrap: break-word;
overflow-wrap: break-word;
• 不要只写
overflow-wrap 就以为万事大吉• 测试真机(尤其是 iPad mini 5 这类仍跑 iOS 13 的设备),模拟器可能不复现
最易被忽略的一点:所有这些属性都依赖父容器有**明确的宽度约束**。如果外层是 position: absolute 且没设 width 或 left/right,或者 flex 容器没配 flex-basis,那么无论怎么调 word-break 都不会生效——浏览器根本不知道“该在哪折”。











