Bootstrap 5 彻底移除 jQuery 是因原生 DOM API 和 ES6 类已足够稳定高效,jQuery 成为冗余负担;其组件如 Modal 必须用 new bootstrap.Modal(el) 显式初始化,$().modal() 因 $ 未定义而报错,data-bs-toggle 仅自动初始化初始 DOM 元素,依赖严格属性名匹配与 CSS 动画支持。

Bootstrap 5 彻底移除 jQuery 不是为了“删着玩”,而是因为原生 DOM API 和 ES6 类已经足够稳定、高效,且 jQuery 的抽象层在现代浏览器中成了冗余负担——它既拖慢解析,又掩盖细节,还阻碍调试。
bootstrap.Modal 构造器为什么不能用 $().modal() 替代
因为 bootstrap.Modal 是一个标准 ES6 类,必须显式传入 DOM 元素实例化;而 $().modal() 是 jQuery 插件函数,依赖 $ 全局对象和 jQuery 的元素包装逻辑。两者运行时环境完全隔离:$ 在 Bootstrap 5 中根本未定义,调用即报 ReferenceError: $ is not defined。
-
document.querySelector('.modal')返回单个Element,可直接传给new bootstrap.Modal() -
$('.modal')返回 jQuery 对象,内部是封装的数组+方法链,bootstrap.Modal完全不认识这个类型 - jQuery 的隐式集合遍历(如自动对所有匹配元素调用
.modal())在原生 API 中不存在,必须手动querySelectorAll().forEach()
data-bs-toggle="modal" 背后发生了什么
Bootstrap 5 的 JS 初始化逻辑只扫描含 data-bs-toggle 属性的元素,并按值(如 "modal")映射到对应类(Modal),然后执行 new bootstrap.Modal(el)。它不解析 data-toggle,也不监听 click 后调用 jQuery 方法——旧逻辑已从源码里删干净了。
- 属性名带
bs-是硬编码匹配,不是配置开关;漏写前缀 = 属性被完全忽略 - 该机制仅对初始存在于 DOM 的元素生效;动态插入的按钮需手动初始化
- 如果
bootstrap.bundle.min.js未加载完成,或脚本执行早于 DOM 就绪,data-bs-toggle会静默失效,控制台也不报错
为什么移除 jQuery 后首屏 JS 解析快了 30–50ms
不是单纯少了 87KB 的 jquery.min.js,而是去掉了三层开销:jQuery 自身的初始化、其事件系统的兼容性兜底逻辑、以及对原生 API 的二次封装调用栈。Bootstrap 5 直接用 addEventListener、Element.classList、CustomEvent,调用链更短,内存占用更低。
- 原生
querySelector比 jQuery 的选择器引擎快约 2–3 倍(尤其在复杂嵌套结构中) - 不再需要维护 jQuery 数据缓存(
$.data()),减少 GC 压力 - 事件统一基于标准
CustomEvent,避免 jQuery 事件命名空间与原生事件混用导致的泄漏风险
最容易被忽略的是:移除 jQuery 后,你不能再假设“写了 data-bs-toggle 就一定有动画”。.modal.fade 这个 class 必须存在,且对应的 CSS transition 声明(opacity 和 transform)必须已加载并生效——JS 只监听 transitionend,不负责补样式。时机错一毫秒,动画就退化成硬切。


















