Bootstrap 5 彻底移除 jQuery 依赖，所有组件基于原生 DOM API 实现；必须使用 data-bs-* 属性、bootstrap.bundle.min.js，并在 DOM 就绪后手动初始化组件。
Bootstrap 5 不再需要 jQuery —— 这不是“可选移除”，而是底层重写后的硬性事实。所有组件（Modal、Dropdown、Tooltip）现在完全基于原生 DOM API 和 CustomEvent 实现，引入 jQuery 不仅无用，还会白占内存、拖慢首屏解析。
data-toggle 失效？只认 data-bs-toggle
控制台没报错，但下拉菜单点不动、模态框不弹出，大概率是属性名没升级。Bootstrap 5 的 JS 完全不监听 data-toggle，只响应带 bs 前缀的版本。
- 必须全局搜索替换：
data-toggle→data-bs-toggle，data-target→data-bs-target，data-dismiss→data-bs-dismiss - 漏掉一个
data-trigger就可能导致Popover初始化失败 - 检查元素时看到旧属性，不代表它在起作用；Bootstrap 5 的 JS 根本不会读取它们
Uncaught ReferenceError: bootstrap is not defined 怎么办
这个错误高频出现在手动调用 bootstrap.Modal.getInstance() 时，根本原因不是文件没引，而是执行时机错了。
-
bootstrap.bundle.min.js必须在调用前加载并执行完毕，否则bootstrap全局对象不存在 - 初始化代码不能写在
里，也不能放在 script 标签顶部；必须包在DOMContentLoaded或放在底部 - 使用 CDN 时，别依赖
defer而不校验执行顺序；推荐显式加type="module"或用load事件监听
为什么 Modal.show() 会报 TypeError: $ is not a function
这是 jQuery 风格写法残留的典型症状。Bootstrap 5 彻底废弃了 $().modal('show') 这类链式调用，也不再暴露 $ 全局变量。
立即学习“前端免费学习笔记（深入）”；
- 正确做法是：先用
document.querySelector获取元素，再传给bootstrap.Modal构造器 - 示例：
const myModal = new bootstrap.Modal(document.getElementById('myModal'));<br>myModal.show(); - 如果之前大量使用 jQuery 选择器，建议封装一层适配函数，但不要试图“模拟” jQuery 行为——性能和可维护性都会受损
- Popper.js v2 配置项也变了，比如
boundary改成boundaryElement，不更新会导致定位偏移
移动端 touchstart 为什么没反应
Bootstrap 5 默认不监听 touchstart，只响应 click 和 pointerdown。这不是 bug，是设计取舍：它把触摸逻辑交还给开发者，避免模拟带来的兼容性陷阱。
- 在 iOS Safari 上，单次点击仍能触发
click（浏览器自动映射），但长按、滑动等需自行监听touchend并调用toggle() - 示例（让下拉支持轻点）：
const el = document.querySelector('[data-bs-toggle="dropdown"]');<br>el.addEventListener('touchend', e => {<br> e.preventDefault();<br> bootstrap.Dropdown.getInstance(el)?.toggle();<br>}); - 务必加
e.preventDefault()，否则在overflow: auto区域内可能触发意外滚动或关闭 - 真要支持复杂手势（如轮播滑动），得绕过 Bootstrap，直接操作 DOM 或引入第三方手势库
最易被忽略的一点：Bootstrap 5 的组件初始化不是“声明即生效”。即使写了 data-bs-toggle，若对应 JS 文件未加载完成，或 DOM 尚未就绪，交互就会静默失效——它不像 jQuery 那样靠后期委托兜底，而是严格依赖执行时序与属性规范。
