npm install bootstrap 只装 bootstrap 源码，不自动安装 @popperjs/core（v5+必需）和 jquery（v4 或旧插件才需）；需显式执行 npm install bootstrap @popperjs/core，否则 js 组件报 popper 未定义错误。
npm install bootstrap 会装什么？
执行 npm install bootstrap 默认只装 Bootstrap 的源码（dist/ 下的 CSS/JS 文件 + js/src/ 等），不带 jQuery 或 Popper——但 Bootstrap 5+ 的 JS 组件（如 Dropdown、Modal）依赖 @popperjs/core，而 npm 安装时不会自动连带装它。
常见错误现象：Uncaught ReferenceError: Popper is not defined，尤其在手动引入 bootstrap.bundle.js 失败后换用 bootstrap.js 时高频出现。
- 必须显式安装：
npm install bootstrap @popperjs/core - 如果项目已用 jQuery（Bootstrap 4 或部分旧插件场景），才需额外加
npm install jquery；Bootstrap 5 默认弃用 jQuery -
node_modules/bootstrap/dist/是最常用路径，CSS 用bootstrap.min.css，JS 优先用bootstrap.bundle.min.js（含 Popper）
如何在 Webpack/Vite 项目里正确 import？
直接 import 'bootstrap' 会报错：它默认导出的是空对象，且不处理 CSS。必须拆开加载样式和脚本，并确保 CSS 提前解析。
使用场景：现代构建工具中启用 Sass 支持、或想定制变量（比如改 $primary 颜色）。
- CSS 部分建议从
bootstrap/scss/bootstrap.scss导入，方便覆盖变量：import '../node_modules/bootstrap/scss/bootstrap.scss'; - JS 部分用
import * as bootstrap from 'bootstrap';，然后调用new bootstrap.Modal(...) - 若用 Vite，需确认
vite-plugin-sass已启用；Webpack 则要配好style-loader+css-loader+sass-loader - 别 import
bootstrap/dist/js/bootstrap.js——它不包含模块导出，仅用于 script 标签直引
为什么 npm 版本号和官网文档对不上？
Bootstrap 官网文档默认以最新稳定版（如 v5.3.x）为准，但 npm install bootstrap 可能拉到旧版（比如锁在 v5.2.x），尤其当项目已有 package-lock.json 或用了老旧 registry。
性能 / 兼容性影响：v5.3 加了新的 data-bs-theme="dark" 暗色支持，v5.2 不识别；v5.2 的 Offcanvas API 在 v5.3 有 breaking change。
- 查当前装的版本：
npm list bootstrap - 升到最新兼容版：
npm install bootstrap@^5.3.0（注意^允许小版本更新，~只允许补丁） - 如果团队共用项目，务必提交更新后的
package-lock.json，否则别人npm install还是旧版
CDN 和 npm 安装混用会怎样？
会冲突。比如页面用 CDN 引了 bootstrap@5.3.3，JS 代码又通过 npm import bootstrap@5.2.3，两个版本的 Modal 构造函数行为可能不一致，导致 show() 无反应或重复初始化。
容易踩的坑：开发时用 npm，上线却切到 CDN（为了加速），但忘了删掉 import 语句，结果样式和脚本来自两个版本。
- 统一入口：要么全走构建流程（npm + import），要么全走 CDN（script/link 标签），不要交叉
- 检查浏览器控制台：搜索
bootstrap，看window.bootstrap是否存在——CDN 会挂载，npm import 不会（除非手动赋值） - 如果必须保留 CDN，就删掉所有
import 'bootstrap'和import * as bootstrap，改用全局bootstrap.Modal
实际项目里最容易被忽略的，是 @popperjs/core 的版本与 Bootstrap 的匹配关系——v5.3 要求 @popperjs/core@^2.11.8，低了会丢箭头定位，高了（如 v2.12+）某些方法签名变了，Modal 就关不掉。
