transition-all 不能直接缩 sidebar 宽度，因 Tailwind 宽度类编译为固定 width 值，而 flex 布局下浏览器可能跳过 width 过渡触发 layout 变更导致跳变；应改用 max-width + min-w- 锁定尺寸区间并显式过渡。
transition-all 为什么不能直接缩 sidebar 宽度
直接给侧边栏加 transition-all 并在折叠时切换 w-64 → w-16，动画大概率会失效或卡顿。原因在于 Tailwind 的宽度类（如 w-16、w-64）最终编译为 width: 4rem / width: 16rem 这样的 CSS 声明，而 transition-all 确实能过渡 width，但前提是元素的 width 必须是「可计算的内联值」或「明确声明的初始值」——如果侧边栏用的是 flex 布局（比如 flex-shrink-0 + min-w-[4rem]），浏览器可能跳过 width 过渡，转而触发 layout 变更，导致跳变。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 避免仅依赖
transition-all，显式指定要过渡的属性：transition-width duration-300 ease-in-out - 确保侧边栏有明确的 width 基准：不要只靠
w-64类控制，改用style="width: 16rem"或min-w-[16rem] max-w-[16rem]锁定尺寸区间 - 折叠状态推荐用
w-16+min-w-[4rem]（不是w-16→w-0），因为 width: 0 会导致子元素无法参与过渡（如图标文字突然消失）
用 max-width 替代 width 实现更稳的折叠动画
比起硬切 width，用 max-width 更可靠：它允许内容自然收缩，且不会因子元素最小尺寸（如按钮、图标容器）阻断动画。Tailwind 没有内置 max-w- 的过渡类，所以得自己加。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在 CSS 中补充：
.sidebar-transition { transition: max-width 300ms ease-in-out; } - HTML 中这样写：
<aside class="sidebar-transition max-w-[16rem] min-w-[4rem] [&.collapsed]:max-w-[4rem] [&.expanded]:max-w-[16rem]">
- 用 JS 切换
collapsed/expanded类，而不是直接操作w-工具类 - 注意：
min-w-[4rem]是必须的，否则max-w-[4rem]折叠后可能被内容撑开（比如未设置overflow-hidden的文本）
折叠时图标和文字的渐显/隐藏需要单独处理
只动容器宽度，里面的文字不会自动淡出；强行用 opacity-0 会破坏可访问性（屏幕阅读器仍读取）。更合理的方式是结合 overflow-hidden 和子元素的过渡控制。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 给侧边栏加
overflow-hidden，防止折叠时内容溢出 - 文字区域用
whitespace-nowrap opacity-100 [&_span.collapsed]:opacity-0 [&_span.expanded]:opacity-100控制显隐 - 图标保持固定尺寸（如
w-6 h-6），不随宽度缩放，避免模糊或错位 - 如果用
group，确保父容器有group类，子元素用group-[.collapsed]:opacity-0—— 但注意：Tailwind v3.4+ 才支持带点号的选择器语法，旧版需用自定义插件或 JS 控制类名
移动端适配与 overflow-x 隐藏容易被忽略
折叠后的侧边栏在小屏上若没处理好，可能出现横向滚动条，或者折叠态下依然能拖动看到隐藏内容。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 给 body 或 layout 根容器加
overflow-x-hidden，防止折叠动画期间产生临时水平溢出 - 侧边栏自身加
overscroll-none（或scrollbar-hide自定义类）避免滚动条闪现 - 在媒体查询中禁用折叠动画：
@media (max-width: 768px) { .sidebar-transition { transition: none; } }，因为小屏通常直接隐藏 sidebar，不需要动画 - 用
data-collapsed属性代替 class 控制状态，方便用 prefers-reduced-motion 媒体查询降级：@media (prefers-reduced-motion: reduce) { .sidebar-transition { transition: none; } }
