Hexo 自动化发布指南：从本地创作到 Cloudflare 自动部署

很多小伙伴在刚接触 Hexo 时，会被各种 generate、deploy 命令搞晕。今天整理一套最适合“Cloudflare Pages + GitHub”架构的发布流程。

在此架构下，你不再需要手动生成 HTML，只需要把 Markdown 源码交给 GitHub，Cloudflare 就会自动帮你完成剩下的工作。

---

核心常用命令速查表

在开始流程前，先记住这几个最高频的命令：

命令	简写	作用
hexo new "标题"	hexo n	创建一篇新文章
hexo clean	hexo cl	清除缓存（当样式不生效时必点）
hexo server	hexo s	启动本地预览 (localhost:4000)
hexo generate	hexo g	手动生成静态文件（本地调试用）

---

完整发布流程：从零到上线

第一步：创建新文章

打开终端（或 CMD），进入你的博客根目录，输入：

hexo new "我的第一篇自动化博客"

此时，Hexo 会在 source/_posts/ 目录下生成一个 我的第一篇自动化博客.md 文件和一个与他同名的文件夹用来存放图片（前提要在配置文件中开启）。

第二步：编辑内容

使用你喜欢的编辑器（如 VS Code 或 Typora）打开这个 .md 文件。

• Front Matter：文件顶部 --- 之间的部分，可以修改标题、日期、分类和标签。
• 正文：在第二个 --- 之后开始书写你的 Markdown 内容。

第三步：本地预览（重要）

在正式发布前，务必先在本地看看效果：

hexo clean && hexo s

打开浏览器访问 http://localhost:4000。如果看到内容和样式都满意，就可以准备“交作业”了。

第四步：使用 Git 提交并推送

这一步是触发 Cloudflare 自动更新的关键。在终端依次输入：

1. 添加文件到暂存区：

   git add .

2. 提交记录：

   git commit -m "Add: 新增了一篇关于保活的博客"

3. 关联到 GitHub 远程仓库：

   git remote add origin <url>

4. 推送到 GitHub：

   git push -u origin main

---

发生了什么？（幕后逻辑）

当你执行完最后一步 git push 后：

1. GitHub 接收到了你的源码更新。
2. Cloudflare Pages 监测到 GitHub 仓库变动。
3. 自动构建：Cloudflare 在云端自动运行 hexo generate。
4. 全球分发：大约 1 分钟后，你的博客新文章就会出现在你的域名下。

---

进阶小技巧

1. 快速修正

如果你发现文章写错了，只需修改 .md 文件，然后重复 第四步 的 Git 三连操作即可。

2. 关于图片

建议将图片放在 source/ 目录下的同名文件夹中，在 Markdown 中使用路径 图片名.png 引用。

---

总结

现在的博客发布流程已经非常简化：写稿 -> 预览 -> Push。 不再需要去折腾复杂的 hexo d 插件配置，这正是 Cloudflare Pages 架构的魅力所在！

温馨提示：如果 Push 之后发现博客没更新，可以登录 Cloudflare 控制台查看 Builds 日志，看看是不是哪里配置出错了。

给你的额外建议：

1. 文章日期：我在 Front Matter 里写的日期是 2026-01-03，如果你还没到这个时间，Hexo 默认可能不会显示这篇文章（因为它认为这是“未来文章”）。你可以把日期改成当前时间。
2. 文件名：hexo new 后面的标题如果包含空格，建议用英文引号包起来。