Bolt.new 部署与发布

别把“部署成功”理解成线上可用。Bolt.new 项目最常见的情况是构建过了，但路径、环境变量或静态资源没对上，打开以后还是白屏或者缺样式。

#最稳的策略

先做一次最小可部署验证。也就是：

• 先选一个最简单的平台把它发出去
• 确认首页能打开
• 确认关键流程能走通
• 再考虑长期托管和工程化迁移

别第一天就同时研究 CDN、CI、域名和多环境配置。那样很容易把原型阶段拖死。

#常见发布路径

如果只是 demo，我还是建议先走最短路径。先有 URL，再谈优化。

#为什么很多人部署后会翻车

最常见的不是代码错，而是这几类配置问题：

• 构建命令不对
• 输出目录搞错
• 环境变量漏了
• 静态资源路径没改

尤其是从 Bolt.new 导出的 Vite 项目，迁到某些静态托管环境时，经常会因为 base 没处理好，导致样式和图片路径出问题。这类问题看起来像“项目坏了”，其实只是部署配置不对。

#环境变量一定要先整理

如果项目里有 API key、数据库地址或外部服务地址，别把真实值放进 Prompt 里。更稳的做法是：

1. 先让项目里有 .env.example
2. 把需要的变量名写全
3. 真实值只在本地或平台环境变量里补

常见示例：

text复制
DATABASE_URL=
OPENAI_API_KEY=
NEXT_PUBLIC_API_BASE=

这一步看起来不酷，但它几乎决定你后面会不会反复出环境问题。

#上线前至少确认这 3 件事

1. build command 是不是正确
2. 输出目录是不是和平台配置一致
3. 所有必需环境变量是不是都已经补齐

很多“线上打不开”的项目，最后就卡在这三条里。

#导出到本地以后我会先做什么

如果你准备把项目带离 Bolt.new，我建议先做这几步：

• 跑一次 npm install
• 跑一次 npm run build
• 看有没有缺失配置或路径问题
• 把 README 和 .env.example 补上

先本地构建成功，再推到托管平台，心里会稳很多。

#常见问题

#首页能开，但样式全丢了

优先检查静态资源路径和平台的 base path 配置。

#构建通过，但页面白屏

先看浏览器控制台，再看环境变量。很多白屏其实是运行时缺配置。

#明明是 demo，为什么部署搞这么久

通常是因为项目还没从“原型状态”收一下。先删掉不必要的依赖和半成品逻辑，部署会简单很多。

#下一步

部署打通以后，如果你发现项目开始变成长期维护对象，就不要继续完全依赖在线原型环境了。那时候该把代码迁回本地工程，进入正常开发节奏。