用 GitHub + Cloudflare Pages 管理博客：跳过构建与本地预览指南

在用 GitHub + Cloudflare Pages 部署博客的过程中，有两个很实用的需求： 频繁改代码但不想每次都触发 Cloudflare 构建，以及在没有部署的情况下本地预览效果。 本文整理了这两个问题的解决方案。 ## 一、如何跳过 Cloudflare Pages 自动部署 默认情况下，每次 push 到 GitHub 都会触发 Cloudflare Pages 重新构建。 免费版每月有 500 次构建限制，频繁改动容易浪费额度。 ### 方法一：commit 信息加 [skip ci] 在 commit 信息里加上这个关键词，Cloudflare 会自动跳过本次构建： git commit -m "调整样式 [skip ci]" 适合偶尔不想触发部署的情况，可以灵活控制每次 push 是否构建。 ### 方法二：关闭自动部署 进入 Cloudflare Pages 后台： Settings → Builds & deployments → Branch control 把 Production branch 的自动部署关掉。之后所有 push 都不会触发构建， 需要发布时手动去 Deployments → Create deployment 触发。 ### 推荐方式 两种方法结合使用效果最好：平时调试用 [skip ci] 跳过， 确认要上线的 commit 正常写，自动部署就会触发。 ## 二、没有部署到 Cloudflare，如何在本地预览效果 ### 方法一：npm run dev 本地预览 在项目目录下运行： npm run dev 打开 http://localhost:4321 即可实时预览。 改动代码后页面自动刷新，是最快的开发方式，不需要构建也不需要部署。 ### 方法二：连接本地 D1 数据库 如果需要看带真实数据的完整效果，先在本地建表： npx wrangler d1 execute shaiblog --local --file=schema.sql 然后运行 npm run dev，本地也能看到完整的文章、书签、标签数据。 ### 方法三：Cloudflare 预览环境 每次 push 到 GitHub，Cloudflare Pages 会生成一个独立的预览链接： https://[commit-hash].shaiblog.pages.dev 不影响正式域名，专门用来预览测试。 ## 推荐的完整工作流 改代码 → npm run dev 本地看效果 → 满意了 → git push（正常 commit，触发 Cloudflare 自动部署） → 还在调试 → git push -m "xxx [skip ci]"（不触发部署） 本地预览速度最快，改完立刻看到结果，不用等任何部署时间。 确认没问题再正式 push，既节省构建次数，也避免把半成品推到线上。