真正可用的响应式侧边导航栏需将搜索框置于offcanvas-body内、用sidebar-inner固定定位、加me-2缓冲、监听focusin收菜单、用display切换过滤项，缺一不可。
真正可用的响应式侧边导航栏，不能只靠 col-md-3 d-none d-sm-block —— DOM 仍占位、键盘焦点跳过、屏幕阅读器误读，小屏下搜索框甚至根本不会渲染。
搜索框必须塞进 offcanvas-body 里，否则小屏下不出现
Bootstrap 5 的响应式逻辑依赖 offcanvas 把侧边栏临时移出文档流。把 <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，和offcanvas-body的内边距叠加后容易撑出容器
position: fixed 侧边栏在桌面端怎么写才不偏移
直接给 .col-md-3 加 position: fixed 会脱离栅格流，导致右侧内容上移、宽度错乱。真正该固定的是列内部的容器。
- 结构上：把菜单包进
<div class="sidebar-inner">，再对它设position: fixed; start-0 top-0 h-100; width: 260px; - 右侧主内容必须加
ms-md-3（不能只靠col-md-9），否则大屏下会被遮挡 - 外层
.row和.container-fluid要清掉默认边距：m-0 p-0 - 菜单过长时，
sidebar-inner加overflow-y-auto，别指望父容器自动截断
iOS 下搜索框失焦、键盘闪退的三个硬性处理点
这不是样式问题，是 Safari viewport overflow 保护机制被触发的真实报错，现象包括横向滚动条弹出、输入框瞬间失焦、软键盘闪退。
-
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 后菜单会卡住
动态过滤菜单项时，别删 DOM，用 display 切换
实时搜索匹配后，直接 remove() 或重写 innerHTML 会导致焦点丢失、键盘导航中断、A11Y 属性失效，尤其菜单项超过 50 条时。
- 只切换
style.display = 'none'或'block'，保留原有 DOM 结构和 tabindex - 避免在每次
input事件中全量遍历并操作节点，可先缓存querySelectorAll('.nav-link')结果 - 若菜单项来自后端，建议前端本地缓存原始数据，过滤走 JS
filter()，而非反复请求
固定定位 + 搜索 + iOS 键盘 + 可访问性，四个条件同时满足时，任何一个环节漏掉 me-2、focusin 监听或 display 切换，都会让整个交互链断裂。这不是“差不多能用”，而是 A11Y 和移动端体验的硬门槛。
