在 Vue 3 项目中不可直接集成 Bootstrap JS，因其依赖 jQuery 和 Popper v1 且与 Vue 响应式机制冲突；应仅引入 CSS 或选用 bootstrap-vue-3、vue-bootstrap-5 等 Vue 3 原生适配方案，并注意样式隔离与初始化时机。
不能在 Bootstrap 中“集成 Vue.js”——方向反了。Bootstrap 是纯 CSS/JS 框架，它不依赖、也不感知 Vue；真正要做的，是在 Vue 项目里安全引入 Bootstrap 的样式和（可选）交互能力。
Vue 3 项目里直接 import bootstrap/dist/js/bootstrap.min.js 会报错
常见错误是 TypeError: Cannot read properties of undefined (reading 'offsetParent')，或下拉菜单、Tooltip 完全不响应。根本原因是：bootstrap 的 JS 组件强依赖 jQuery 和 Popper v1，而 Vue 3 已彻底移除对 jQuery 的兼容，且其 DOM 更新时机与 Bootstrap 原生 JS 初始化逻辑冲突。
- 纯 CSS 功能（栅格、
.btn、.form-control等）可安全使用：import 'bootstrap/dist/css/bootstrap.min.css' -
bootstrap/dist/js/bootstrap.bundle.min.js在 Vue 3 中必须禁用 —— 即使 import 了，也大概率静默失效 - 如果你看到文档写“引入 JS 就能用 Modal”，那基本是面向 Vue 2 或原生 HTML 场景的，不适用于当前 Vue 3 + Vite 或 Vue CLI 5+ 项目
想用 Modal/Dropdown/Tooltip？换用 Vue 原生封装库
推荐两个明确支持 Vue 3 的方案，别再碰原生 Bootstrap JS：
-
bootstrap-vue-3：最稳妥。安装npm install bootstrap-vue-3，在main.js中app.use(BootstrapVue3)，组件名统一为<bbutton></bbutton>、<bdropdown></bdropdown>。它不操作真实 DOM，完全基于 Composition API，和 Pinia、Router 无冲突 -
vue-bootstrap-5：适合想保留data-bs-toggle="modal"这类写法的团队。需手动调用initBootstrap()，并在组件中用ref绑定元素，再通过useBootstrapModal(ref)激活。注意：不支持 SSR，大量组件时初始化有微小延迟
全局样式冲突和变量覆盖必须提前处理
Bootstrap 的默认样式会污染全局，比如 body { margin: 0 } 被覆盖、button { user-select: none } 影响可访问性、.form-control 的 focus outline 覆盖你自定义主题。这不是“能用就行”的问题，而是上线后可能被审计工具标红的合规风险。
立即学习“前端免费学习笔记（深入）”；
- 不要全局 import
bootstrap/dist/css/bootstrap.min.css后就不管 —— 至少抽离出bootstrap/scss/_reboot.scss和_variables.scss，用 Sass 变量覆盖重置行为 - 如果用了
bootstrap-vue-3，它的 CSS 是 scoped 到组件内的，但依然会继承全局body和html样式，所以reboot部分仍需干预 - 检查
!important使用点：Bootstrap 5 默认已极少用，但某些插件（如bootstrap-icons）CSS 里仍有，需用 CSS 层叠顺序压制，而非删源码
最常被忽略的是初始化时机：哪怕用了 bootstrap-vue-3，如果 Modal 内容含异步加载的子组件，v-model 切换太快可能导致内部 ref 未绑定完成就渲染 —— 这时不是框架问题，是你没等 nextTick 或 onMounted 就触发了 show。
