Bolt.new Deployment Guide

Bolt.new 现在的部署心智需要更新一下。按照官方帮助中心当前说明，新项目默认可以直接发到 Bolt hosting，旧项目如果是 2025 年 8 月 14 日之前走 Netlify 的，还要区分旧发布链路和新 hosting 逻辑。所以“怎么发出去”不再只是一个按钮问题，而是要先搞清楚你处在什么项目状态。

#先把发布目标分清楚

你到底是在做哪一种发布，决定了后面会不会走弯路：

• 只是拿一个公开或受限链接给别人看 demo
• 想长期维护并接到 GitHub 或别的托管平台
• 想把早期 Netlify 项目迁回 Bolt hosting

如果只是 demo，先用最短路径就好。
如果已经准备长期维护，最好尽快接 GitHub，把代码和发布控制权拿在自己手里。

#当前常见的三条路径

官方现在已经明确: 新项目默认走 Bolt hosting，而不是历史上的 Netlify 默认路径。这个变化值得记住，因为很多旧教程已经过时了。

#最稳的部署顺序

不要一上来就研究域名、CI、分析脚本和多环境。先做一次最小验证：

1. 发布到一个能拿到 URL 的地方
2. 打开首页确认不是白屏
3. 手动走一遍关键流程
4. 再决定要不要接自定义域名、GitHub、外部托管

这个顺序看起来慢，实际上返工更少。

#为什么发布后最容易翻车

很多人以为是代码问题，实际上更常见的是这些基础配置：

• build command 不对
• output directory 没配对
• 必需 env 漏了
• 静态资源路径和实际托管环境不匹配

尤其是导出后再自己托管的项目，如果底层是 Vite 或有静态资源前缀要求，路径一错，页面就会表现成“部署成功但打不开样式”。

#环境变量别写死在 prompt 里

如果项目接 API、数据库或第三方服务，最好一开始就把环境变量意识带进来：

1. 补一个 .env.example
2. 写清楚变量名和用途
3. 真实值只放在本地或托管平台配置里

这样以后切换 Bolt hosting、Netlify、Vercel 或本地导出，都不会太痛苦。

#什么时候该接 GitHub

Bolt 官方现在已经把 GitHub 集成做成一条清晰路径，这件事很重要。只要项目满足下面任一条件，就值得尽早接 GitHub：

• 你准备长期维护
• 你需要回滚和版本历史
• 你可能会离开 Bolt 去别的托管环境
• 团队里不止一个人会碰这套代码

不要等项目已经开始变复杂了，才想起把它同步出去。

#上线前至少确认这几项

• 首页能正常打开
• 主流程能从头走通
• 必需环境变量都已配置
• 分享链接或公开链接权限符合预期
• 如果是旧 Netlify 项目，已经确认是不是要切到 Bolt hosting

#一个经验判断

对原型来说，“能发布”真正意味着的是“别人可以稳定看到并复现你的主流程”。
如果现在还做不到这一点，就先别急着把它包装成正式上线。

#Related pages

• First app
• Prompt guide
• Bolt overview