不推荐仅为“移除 jQuery”升级 Bootstrap 5；虽更轻更快，但会导致 JS 行为断裂、CSS 语义重构、构建链路重配，若无 jQuery 维护或性能瓶颈，强行升级反增风险。
直接说结论：不推荐只为“移除 jQuery”这个单一理由升级到 Bootstrap 5。它确实更轻、更快，但代价是 JS 行为断裂、CSS 语义重构、构建链路重配——如果你的项目没卡在 jQuery 维护或性能瓶颈上，强行升级反而增加风险。
bootstrap is not defined 错误几乎全是加载时机问题
这个错误不是文件没引入，而是执行顺序错了。bootstrap 是一个全局对象，只在 bootstrap.bundle.min.js 执行完后才存在。
- 把
new bootstrap.Modal(...)写在<head>里，100% 报错 - 即使加了
defer，某些旧版 Safari 或低配 Android 浏览器仍可能抢在 JS 执行前跑初始化代码 - 正确做法：用
DOMContentLoaded包裹，或把脚本放</body>前
document.addEventListener('DOMContentLoaded', () => {
const myModal = new bootstrap.Modal(document.getElementById('myModal'));
myModal.show();
});data-bs-toggle="modal" 点击无效？先确认是否还在用 jQuery 风格写法
v5 的 data-bs-toggle 不是“增强版 v4 属性”，它是全新触发逻辑的入口：
- 它只在页面加载时自动扫描一次，找到匹配元素就调用
new bootstrap.Modal(el) - 如果你手动写了
document.getElementById('trigger').click()，但没提前初始化对应 Modal 实例，点击完全静默（v4 会自动补） - 漏掉
data-bs-target或拼错成data-target，控制台不报错，但 modal 打不开
常见疏漏点：
- 全局搜索替换时漏掉
data-dismiss→data-bs-dismiss，导致 alert 关不掉 - 复制 v4 文档 HTML 示例，直接粘贴进 v5 页面，
data-toggle属性被完全忽略
querySelectorAll('[data-bs-toggle]') 不能直接传给 bootstrap.Modal 构造器
querySelectorAll 返回的是 NodeList，而 bootstrap.Modal 只接受单个 Element。
- 错误写法：
new bootstrap.Modal(document.querySelectorAll('[data-bs-toggle="modal"]'))→ 报TypeError: Cannot read property 'ownerDocument' of undefined - 正确写法：必须遍历
document.querySelectorAll('[data-bs-toggle="modal"]').forEach(el => { new bootstrap.Modal(el); }); - 如果需要统一控制（比如全部关闭），得自己存实例：
const modals = []，每次modals.push(new bootstrap.Modal(el))
别用 document.querySelector('.modal').classList.add('show') 强行模拟——这绕过所有生命周期，后续调用 .hide() 会失效。
真正影响迁移成本的，从来不是体积少了 87KB，而是你是否准备好处理那些没有报错却悄悄失效的行为：自动初始化跳过、事件委托失效、表单验证伪类不触发、Sass 变量编译失败……这些地方一旦漏测，上线后用户点不动、输不对、看不见，问题才真正开始。
