先说结论
AI 生成网页部署上线的最短路径是:把产物整理成一个含 index.html 的文件夹 → 推到 GitHub → 在 Netlify / Vercel / Cloudflare Pages 上一键导入 → 绑域名、开 HTTPS,全程不需要碰服务器。真正卡住人的往往不是部署这一步,而是部署前的三件事:首页文件名对不对、构建命令能不能跑通、环境变量有没有同步过去。
本文按”生成 → 本地自测 → 选平台 → 上线 → 上线后检查”的顺序讲,给出可以直接复制的命令与配置,也列出 AI 生成项目最常见的几类构建失败原因。
第一步:把 AI 的产物整理成可部署结构
AI 工具(Bolt 、 v0 、 Lovable 、各类对话式生成)吐出来的代码有两种形态,处理方式不同:
- 纯静态(HTML + CSS + JS,无框架):只要保证首页叫
index.html、资源用相对路径引用,直接可传。 - 框架项目(Next.js / Vite / React):需要
package.json里有正确的build脚本,并先在本地跑通npm run build。
第二步:本地自检清单(跳过这步后面全是坑)
- 本地能正常打开、无控制台报错
npm run build(如有)成功,产物目录存在- 依赖都写在
dependencies而非devDependencies——这是”本地能跑、线上构建失败”的头号原因 - 代码里没有硬编码的密钥;把需要的值写进
.env.example备查 - 图片已压缩、格式统一(能用 WebP 就用 WebP)
第三步:平台怎么选
| 平台 | 最适合 | 免费额度 | 上手方式 |
|---|---|---|---|
| Netlify | 纯静态站、运营自己维护的落地页 | 100GB/月流量 | 拖拽文件夹即可发布 |
| Vercel | Next.js 、需要服务端函数的全栈项目 | 100GB/月流量 | 关联 Git 仓库自动构建 |
| Cloudflare Pages | 要全球加速、流量较大的静态站 | 不限流量 | 关联 Git 或直传 |
| GitHub Pages | 文档、作品集、简单项目页 | 不限 | GitHub Actions 构建 |
| Cloud Run / 容器 | Docker 化、需要长进程的服务 | 按量 | 需自己写 Dockerfile |
第四步:三条上线路径
路径 A:拖拽部署(零命令行,推荐给非技术同学)
登录 Netlify 后台,把放好 index.html 的整个文件夹拖进指定区域,几十秒后拿到 xxx.netlify.app 地址。 Vercel 、 Cloudflare Pages 也支持类似方式。要绑自己的域名,在平台的域名设置里添加,然后去域名服务商后台加一条 CNAME 指向平台给的地址。
路径 B:Git 关联(推荐,改一次推一次自动发布)
git init
git add .
git commit -m "Initial commit"
gh repo create my-app --public --source=. --remote=origin --push
# Vercel
npm i -g vercel
vercel # 先出预览地址
vercel --prod # 确认无误再上生产
之后每次 push 都会自动重新构建,并生成一条独立的预览链接,方便给别人看效果再合并。
路径 C:容器(需要长连接 / 自定义运行时)
让 AI 生成一份 Dockerfile,推到仓库后把 Cloud Run 之类的服务接到仓库上,即可实现推送即部署。代价是要自己管镜像、扩缩容和密钥轮换,非必要不上这条路。
- 整理产物:首页命名为 index.html,资源改为相对路径,删除占位素材。
- 本地验证:确认页面能打开、构建命令能跑通、无硬编码密钥。
- 选平台并部署:静态站用 Netlify/Cloudflare Pages,Next.js 用 Vercel,容器化上 Cloud Run 。
- 配置环境变量:把 .env 里的每一项在平台后台逐个添加,改完记得重新部署才生效。
- 绑域名 + 开 HTTPS + 跑一次 Lighthouse:性能 90+、无障碍 95+ 作为基线存档。
第五步:上线后别立刻收工
- 监控:接一个免费的可用性监控(UptimeRobot 之类),站点挂了比用户更早知道。
- 埋点:优先用轻量统计工具,加载更快、多数场景免 cookie 提示。
- 基线:上线当天跑一次 Lighthouse 并保存分数,之后每次改版有对比基准。
- 内容维护:如果只是偶尔改文案,让 AI 改完重新推一次 Git 即可;若需要运营自己上传内容,再考虑接轻量 CMS 或表单服务。
顺带一提,如果最终还是要一个能长期维护、能被搜索引擎和 AI 好好收录的站点,把生成结果迁到 WordPress 也是常见路线,可参考 WordPress 全站编辑(FSE)实战 与 WordPress 速度优化实测。
为什么本地能跑,部署到 Vercel/Netlify 就构建失败?
环境变量配置了但不生效怎么办?
免费托管的域名和 HTTPS 够用吗?
AI 生成的页面上线后需要备案吗?
上线前 10 项速查
参考来源:Vercel / Netlify 官方文档、 Cloudflare Pages 文档、 Cloud Run 文档。






评论 (0)