静态站最省维护的做法,是让 Cloudflare Pages 直接监听一个独立 GitHub 仓库。每次推送触发构建,失败时旧版本继续在线。
第一次设置
- 为站点新建仓库,不把它塞进现有主站目录。
- Pages 中新建项目并选择仓库。
- 填写构建命令与输出目录;本项目是
npm run build和dist。 - 首次成功后再绑定自定义域名。
部署失败时
先看失败发生在依赖安装、构建,还是上传。不要因为一次失败就修改 DNS。Pages 的历史部署可用于确认最后一个正常版本。
项目隔离很重要:不要复用已有 Worker 名称、Pages 项目或数据库绑定。
最后做一次记录
如果问题解决了,记下真正生效的那一步、设备或浏览器版本,以及你已经撤销的临时改动。下次遇到同类问题,会比收藏十篇教程更有用。