Tailwind 默认 grid-cols-1–12 不支持 5 列、混合轨道等复杂布局，必须通过 theme.extend.gridTemplateColumns 自定义，并确保父容器加 grid 类、断点链完整、配置 content 覆盖路径，否则类名无效。
直接说结论：Tailwind 默认的 grid-cols-1 到 grid-cols-12 无法支撑真实业务中的“5列卡片流”“侧边栏+主内容+工具栏”或“minmax(240px, 1fr) auto”这类布局；必须自定义 gridTemplateColumns，且所有响应式切换都得手动配全断点、显式声明 grid、并验证浏览器是否真正输出了 grid-template-columns。
为什么加了 md:grid-cols-5 却还是单列或错位
根本不是类名拼错了，而是三个关键环节漏了任一环：
- 父容器没加
grid类 ——grid-cols-5不会自动补display: grid，只写它等于白写 - 断点链不完整，比如只写了
grid-cols-1 md:grid-cols-5，那在640px–767px（即sm到md之间）会回退到未定义状态，浏览器按block渲染 - DevTools 的 Computed 面板里查不到
grid-template-columns，说明该类根本没被 Tailwind 编译出来 —— 检查tailwind.config.js的content是否覆盖app/**/*.{js,ts,jsx,tsx}
怎么安全地实现 5 列、7 列或混合轨道（如 240px + 1fr + auto）
不能硬凑 grid-cols-16 或改源码，得走配置扩展路线：
- 在
tailwind.config.js的theme.extend.gridTemplateColumns里加键值对，例如：'5': 'repeat(5, minmax(0, 1fr))'、'sidebar-main-tool': '240px 1fr auto' - 值必须是合法 CSS 字符串，不能缩写（
1fr1fr错，1fr 1fr对），推荐用minmax(0, 1fr)替代纯1fr，防内容撑破 - 含像素值的列（如
240px）要小心自动流行为：子项若跨格，建议加grid-flow-row或显式设grid-row，否则容易错行 - 自定义键名不支持响应式前缀 ——
sm:grid-cols-5无效，必须单独定义'sm:5'和'md:5'
为什么 gap-4 失效、col-span-3 撑出容器、嵌套后间距乱套
这些表象背后是同一个机制：gap 和 col-span 只作用于当前直系 Grid 容器，且强依赖其 grid-template-columns 是否明确定义。
立即学习“前端免费学习笔记（深入）”；
-
gap-4在非grid或flex容器里会被静默忽略；别用mb-4+mr-4模拟，它会干扰列数推算 -
col-span-3是“跨越 3 个列轨道”，不是“占满 3 个子元素宽度”——若父容器是grid-cols-2，再写col-span-3就必然溢出 - 嵌套 Grid 时，父级的
gap对子级 Grid 内部项完全无效；每层 Grid 都要独立设gap - 跨列也要响应式控制：小屏不该跨？写成
md:col-span-2，而不是无前缀的col-span-2
最常被跳过的动作是：打开 DevTools Layout 面板，确认 grid-template-columns 真实存在、display 确实是 grid、且没有其他 CSS（比如 max-width 或 overflow）在暗中干扰轨道计算。一旦漏掉这步，所有类名都只是幻觉。
