hidden 切换会破坏流式布局，因其等价 display: none 导致重排和跳动；应避免与断点类共用、慎用 JS toggle，优先采用位移或 max-h 过渡方案。
hidden 和 block 切换会破坏 DOM 流式布局
因为 hidden 对应的是 display: none，元素完全脱离文档流——不占空间、不参与计算、子元素也不渲染。而 block 只是设为块级显示，但前提是元素本身还在流中。一旦你用 JS 切换 hidden 类，浏览器要重排（reflow），尤其在 flex 或 grid 容器里，兄弟元素会突然“补位”，造成跳动或错位。
常见现象包括：导航栏下拉菜单展开时顶部留白、侧边栏弹出后主内容区宽度突变、响应式卡片网格塌陷。
- 别在 flex 容器直接对子项 toggle
hidden，它会让flex: 1或min-width失效 - 用
opacity-0 invisible替代hidden仅适用于“视觉隐藏”，DOM 仍占位，不能解决空间突变问题 - 若必须用显隐控制，优先考虑位移（如
-translate-x-full/translate-x-0）而非 display 切换
hidden 与断点类（如 md:block）共存时 CSS 优先级混乱
hidden 在 Tailwind v3+ 默认带 !important，而 md:block 是媒体查询内普通声明，无法覆盖。写成 hidden md:block，小屏下 hidden 生效；中屏时，md:block 被 hidden !important 压制，依然不显示——这不是 bug，是设计如此。
更糟的是，如果构建时启用了 PurgeCSS，且没在模板里显式引用 md:block，这个类可能根本没打进 CSS 文件，导致部署后中屏也空白。
立即学习“前端免费学习笔记（深入）”；
- 正确写法是分层声明：默认状态用基础类（如
flex），再用断点类覆盖，例如flex sm:hidden md:flex - 避免
hidden和任何带前缀的 display 类（md:block、lg:flex）写在同一元素上 - 检查 DevTools 的 Computed 面板，确认最终
display值是否被!important锁死
JS 手动 toggle hidden 容易引发状态不同步
原生 JS 写 el.classList.toggle('hidden') 看似简单，但实际有三处隐患：服务端渲染时类名可能未被 Tailwind 扫描到；多个同类型菜单共享同一段脚本，querySelector 选错节点；焦点管理失效（键盘用户打不开下拉菜单）。
比如汉堡菜单和页脚折叠面板都用 document.getElementById('menu').classList.toggle('hidden')，一旦 ID 冲突或加载顺序不对，就全乱套。
- 推荐改用 Alpine.js 的
x-show，它内部用display: none内联样式切换，不依赖类名，也不受 PurgeCSS 影响 - 必须加
x-cloak防闪烁，并配[x-cloak] { display: none; }到全局 CSS - 需要动画？用
x-transition，别自己拼transition-opacity duration-200+hidden，后者根本不会过渡
想做高度/宽度动画？hidden 根本不支持
hidden 切换是瞬时的，没有过渡能力。你想让下拉菜单“慢慢展开”，不能靠 hidden → block，因为 height 从 0 到 auto 无法过渡。Tailwind 也没提供 transition-height 这种类。
可行方案是用 max-h-0 overflow-hidden → max-h-96，并确保 max-h-96 大于菜单最大高度（否则会截断）。配合 transition-all duration-300 ease-in-out 就能实现平滑伸缩。
- 别写
h-0 → h-auto，height:auto 不可过渡 - 别依赖 JS 动态读取真实高度再设内联样式，维护成本高且易出竞态
- 如果菜单项高度差异大，保守设
max-h-[500px]比硬写max-h-96更稳妥
hidden 的强制性、断点类的媒体查询逻辑、PurgeCSS 的类名裁剪、以及浏览器重排的不可预测性——都在同一时间起作用。稍一松懈，布局就错位。 
