Bootstrap纯静态站点部署Vercel需确保根目录仅有index.html且无package.json等框架文件；若用CLI，应加--single --public参数强制静态模式，避免误触发构建流程导致404或样式丢失。
Bootstrap 网页本身是纯静态 HTML/CSS/JS，部署到 Vercel 不需要后端或构建步骤——但很多人卡在 vercel 命令没反应、dist 目录不识别、或者部署后样式丢失，核心原因是没区分「纯静态」和「框架项目」的处理逻辑。
确认你的 Bootstrap 项目是不是纯静态
如果你是直接写 index.html + 引入 CDN 上的 Bootstrap（比如 <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css">），那它就是纯静态站点。Vercel 会自动识别 index.html 为入口，无需配置。
- ✅ 正确做法：根目录下有
index.html，且没有package.json或next.config.js等框架配置文件 - ❌ 错误做法：把 Bootstrap 项目放进
create-react-app或Vue CLI项目里，却没运行npm run build，直接推源码上去——Vercel 会尝试构建，但找不到构建脚本就失败 - ⚠️ 注意：
vercel --prod默认会扫描项目结构，如果检测到package.json，就会走 Node.js 构建流程，哪怕你根本没配build脚本
部署前必须清理的三个干扰项
Vercel 的自动检测很灵敏，但容易被残留文件误导。常见“部署成功但页面空白/404/样式错乱”，往往源于这些：
- 删掉根目录下的
package.json（除非你真在用 npm 管理依赖） - 删掉
node_modules和yarn.lock（它们会让 Vercel 认为你在跑 Node 构建） - 确保
index.html在最外层，不是藏在src/或public/里；如果用了本地 Bootstrap CSS/JS 文件，路径要写对，比如./css/bootstrap.min.css，不能是../css/...
用 vercel CLI 部署时的关键参数
如果你坚持用命令行（而不是拖拽或 Git 集成），别跳过 --single 和 --public：
-
vercel --single --public：强制以纯静态模式部署，忽略任何构建逻辑，直接把当前目录当静态资源根 -
vercel --prod --dir=./dist：如果你已经手动构建出dist/目录（比如用 Webpack 打包了 Bootstrap 模板），就指定它为发布目录 - 不要加
--builds或functions字段——那是给 API 函数用的，和静态页冲突，Vercel 官方明确警告过这种混用会导致部署失败
样式丢失？先检查这几个地方
部署后 Bootstrap 样式不生效，90% 是路径或加载顺序问题，和 Vercel 无关：
- 打开浏览器开发者工具，看 Network 标签页里
bootstrap.min.css是否返回 404；如果是本地文件，确认路径是否相对于index.html正确 - CDN 引入方式中，检查是否漏了
<meta charset="utf-8">—— 缺少这个，Bootstrap 的某些 icon 字体可能渲染异常 - 如果用了 Bootstrap 的 JS 组件（如 Modal、Dropdown），确认是否引入了
bootstrap.bundle.min.js（含 Popper），而不是只引了bootstrap.min.js
真正麻烦的点不在部署动作本身，而在于你分不清自己手里的到底是“一个 HTML 文件”还是“一个假装静态的前端工程”。Vercel 不会替你判断意图，它只认文件结构和配置。一旦误判，错误信息还常伪装成 CORS 或 404，实际只是它在找根本不存在的构建产物。
