真正可用的响应式侧边固定菜单需桌面端用position:fixed锚定内部容器，移动端通过offcanvas移出文档流；搜索框必须置于offcanvas-body内，配合me-2、form-control-sm及display切换显隐，确保ios兼容与可访问性。
真正可用的响应式侧边固定菜单，必须在桌面端用 position: fixed 锚定，移动端彻底移出文档流——只靠 col-md-3 d-none d-sm-block 会留 DOM 占位、键盘焦点跳过、屏幕阅读器误读，小屏下搜索框甚至根本不会渲染。
搜索框必须塞进 offcanvas-body 才能小屏可见
Bootstrap 5 的响应式逻辑依赖 offcanvas 把侧边栏临时移出文档流。把 <form></form> 放在 navbar-collapse 或 row 里，它压根不参与渲染——不是“隐藏”，是 DOM 没生成。
- 正确位置：
<div class="offcanvas-body"> <form><input class="form-control form-control-sm"></form> <ul class="nav"></ul> </div> - 别塞进
navbar-nav同级或navbar-brand后面——那些属于顶部导航逻辑，和侧边栏无关 - 不加
form-control-sm会导致输入框比菜单文字高，视觉割裂；别套input-group，它自带 padding/margin，叠加后容易撑出容器
position: fixed 侧边栏怎么写才不偏移主内容
直接给 .col-md-3 加 position: fixed 会脱离栅格流，导致右侧内容上移、宽度错乱。真正该固定的是列内部的容器。
- 结构上：把菜单包进
<div class="sidebar-inner">，再对它设 <code>position: fixed; start-0 top-0 h-100; width: 260px; - 右侧主内容必须加
ms-md-3（不能只靠col-md-9），否则大屏下会被遮挡 - 外层
.row和.container-fluid要清掉默认边距：m-0 p-0，否则position: fixed会因padding偏移 - 菜单过长时，
sidebar-inner加overflow-y-auto，别指望父容器自动截断 -
form-control在offcanvas或navbar里必须加me-2——提供 0.5rem 右侧安全缓冲，不是为了“好看” - 点击搜索框不收菜单？
offcanvas默认不监听focusin。最简解法：<input data-bs-toggle="offcanvas" data-bs-target="#sidebarOffcanvas"> - 更稳妥做法：监听
focusin，用 JS 主动调用bootstrap.Offcanvas.getInstance(element).hide()；别依赖blur，用户切 App 后菜单会卡住 - 正确做法：用
display: none/display: block切换显隐，保留 DOM 结构和所有事件绑定 - 避免用
visibility: hidden，它仍占空间、仍可被键盘聚焦 - 如果菜单项动态加载，过滤前先缓存原始 DOM 片段，避免反复解析 HTML 字符串
iOS 下搜索框失焦、键盘闪退的硬性处理点
这不是样式问题，是 Safari viewport overflow 保护机制被触发的真实报错，现象包括横向滚动条弹出、输入框瞬间失焦、软键盘闪退。
动态过滤菜单项时，为什么不能删 DOM
实时搜索匹配后，直接 remove() 或重写 innerHTML 会导致焦点丢失、键盘导航中断、A11Y 属性失效，尤其菜单项超过 50 条时。
复杂点在于：同一套 DOM 要同时满足桌面端固定定位 + 移动端 offcanvas 切换 + iOS 键盘兼容 + 可访问性要求，任何环节漏掉一个 me-2、少一个 aria-hidden、或错用一个栅格类，都会在特定设备上突然崩掉。
