指南 / Cloudflare

Cloudflare Pages + GitHub:一套不折腾的发布流程

小型静态站如何隔离项目、固定构建并保留回滚路径。

最后核对 · 2026-09-12 · 6 MIN

静态站最省维护的做法,是让 Cloudflare Pages 直接监听一个独立 GitHub 仓库。每次推送触发构建,失败时旧版本继续在线。

第一次设置

  1. 为站点新建仓库,不把它塞进现有主站目录。
  2. Pages 中新建项目并选择仓库。
  3. 填写构建命令与输出目录;本项目是 npm run builddist
  4. 首次成功后再绑定自定义域名。

部署失败时

先看失败发生在依赖安装、构建,还是上传。不要因为一次失败就修改 DNS。Pages 的历史部署可用于确认最后一个正常版本。

项目隔离很重要:不要复用已有 Worker 名称、Pages 项目或数据库绑定。

最后做一次记录

如果问题解决了,记下真正生效的那一步、设备或浏览器版本,以及你已经撤销的临时改动。下次遇到同类问题,会比收藏十篇教程更有用。