教程
用 GitHub 存文章,发布博客还需要电脑一直开着吗?
以 Knowhy Lab 的真实发布链路拆开说明:文章保存在哪里、草稿和发布分别意味着什么,以及电脑何时必须在线、何时可以关机。

把文章放进 GitHub 之后,最容易混淆的是两件事:写文章时电脑是否要在线,以及文章发布后网站是否依赖这台电脑继续运行。
对 Knowhy Lab 目前这套 Git 驱动的静态站,答案是:创建和提交内容时需要一个能运行命令、连接 GitHub 的环境;文章合并到 main 后,构建和上线由 Cloudflare Pages 的 Git 集成完成,个人电脑不必一直开着。
这不是所有博客的通用结论。它成立,是因为内容、审核和部署被拆成了三个阶段。
文章到底保存在哪里
一篇文章不是只存在浏览器后台里。正文以 Markdown 文件保存,标题、摘要、语言、发布时间、SEO 信息等写在同一个内容文件的 frontmatter 中;封面和正文图片则进入站点的公开媒体目录。
这些文件提交到 Git 仓库后,GitHub 上的远端仓库成为团队可以共同取得的版本记录。每次修改都会留下差异,文章和图片也能一起审阅。
这里要区分“本地文件”和“远端内容”:
- 还没有提交、推送的文件,只在当前电脑上;关机不会丢失文件,但云端也看不到它。
- 已经推送到内容分支的稿件在 GitHub 上有副本,但还没有进入正式站。
- 合并到
main的内容才会进入生产构建。
因此,“使用 GitHub 存文章”不能自动替代提交和推送。远端仓库只有收到变更,才能参与后续流程。
这里的“草稿”是什么
在这套程序化流程里,草稿通常是一条独立的 content/* 分支和对应 Pull Request。它让标题、正文、图片和元数据形成一组可检查的差异,同时不直接修改生产分支。
GitHub 将 Pull Request 定义为从一个分支向另一个分支提出合并变更的方式,适合在合并前讨论、审阅并运行检查。对内容站来说,这意味着“PR 已创建”只表示稿件进入审核,不等于文章已经公开。
还有一个容易误解的细节:普通 content/* PR 不是 Sveltia CMS 自己创建的 cms/* 编辑工作流条目,所以它不保证出现在 Sveltia 的草稿列表里。这两种入口共用同一份内容,但草稿状态的展示方式不同。
发布发生了什么
审核通过后,发布命令会显式确认目标分支,并把内容 PR 合并到 main。随后发生的事都在云端:
- GitHub 保存合并后的正式版本。
- Cloudflare Pages 发现生产分支有新提交。
- Pages 拉取仓库、执行构建并生成静态文件。
- 构建成功后,正式域名开始提供新版本。
Cloudflare 的 Pages 文档说明,Git 集成可以在连接的分支发生变更时自动构建和部署;生产分支与其他预览分支也可以分别控制。Knowhy Lab 把 main 作为生产分支,因此不是“本机把网页持续发送给访客”,而是“本机发起内容变更,云端产出并托管网页”。
这就是为什么合并完成后,个人电脑关机不会让网站下线。访客访问的是 Pages 上的静态产物,不是你的本地开发服务器。
电脑什么时候仍然需要在线
“不必常开”不等于“整个过程不需要运行环境”。以下操作仍需要一台在线设备,或另一套持续运行的执行环境:
- 创建、校验和推送稿件;
- 导入图片并生成内容 PR;
- 在本地预览排版;
- 发出显式合并命令;
- 排查构建失败,或提交修复。
在 Knowhy Lab 的当前工作流中,这些动作由项目内命令在一个受控环境中执行。它可以是个人电脑,也可以将来迁移到合适的 CI 或远程工作环境;但只要命令还只在本机运行,关机时它就不会自动继续创建新稿件。
已经推送或合并的 Git 操作则是另一回事。命令发出后,GitHub 和 Pages 的后续工作不要求原电脑保持连接。
哪些情况不能套用这个结论
如果博客把数据库、图片服务器或构建进程直接跑在家里的电脑上,关机当然会中断服务。使用自托管 runner、只能访问本地文件的私有构建步骤,或者需要长期运行的动态后端,也会重新引入“某台机器必须在线”的依赖。
因此,这套方式适合内容主要由文件构成、可以静态构建、希望用 Git 审核变更的站点。它不意味着所有网站都应该改成静态站,也不等于动态功能不再需要服务器。
发布前可以检查什么
如果你正在搭一套类似流程,至少确认四件事:
- 稿件是否已经推送到远端,而不是只保存在本地;
- PR 的目标是否是实际生产分支;
- Pages 是否真的连接了该仓库和生产分支;
- 合并后是否出现成功部署,并能从正式地址访问新文章。
这四个状态分别对应“内容已保存”“变更可审核”“云端会构建”和“读者已经看到”。把它们分开,才不会把本地完成、PR 创建或构建开始误当成正式发布。
如果还想看这套流程怎样处理图片、审核与撤稿,可以继续阅读让 Codex 发文章和传图片:一次不依赖后台点击的实践。