Hexo 博客维护与操作备忘指南

1. 仓库结构

源码仓库（blog_backstage）

内容：Hexo 配置、文章 Markdown、主题文件、插件配置
用途：多设备同步、修改博客内容
私有推荐

发布仓库（username.github.io）

内容：public/ 生成的静态文件
用途：GitHub Pages 托管博客
公开仓库，直接访问 https://username.github.io

2. 常用命令

本地开发

# 本地启动预览
hexo s           # localhost:4000

# 写文章
hexo new post "标题"
hexo new draft "草稿标题"   # 保存为草稿
hexo publish draft "草稿标题"  # 草稿转正

# 清理缓存（主题换了或配置修改后必须）
hexo clean

# 生成静态文件
hexo g

# 部署到 GitHub Pages
hexo d

# 同步源码仓库
git add .
git commit -m "更新文章/配置/主题"
git push origin main
git pull origin main  # 拉取最新更新

查看远程仓库

git remote -v       # 查看关联的远程仓库
git remote show origin  # 查看跟踪分支和详细信息

3. 多设备操作流程

新设备克隆源码

git clone https://github.com/yourusername/blog_backstage.git
cd blog_backstage
npm install

日常写作流程

git pull                  # 同步最新源码
hexo new post "文章标题"
hexo s                     # 本地预览
hexo clean && hexo g && hexo d  # 生成并部署到 GitHub Pages
git add . && git commit -m "更新文章" && git push

4. 主题管理

下载主题到 themes/ 文件夹

cd themes
git clone 主题仓库地址 主题名

修改 Hexo 配置 _config.yml：

theme: 主题名

主题自带配置

打开 themes/主题名/_config.yml 修改颜色、菜单、评论等

重新生成部署

hexo clean
hexo g
hexo d

5. 部署注意事项

_config.yml 的关键配置：

url: https://yourusername.github.io # 根仓库
root: / # 根路径 / 或子目录 /blog/

主题/插件修改后一定要：

hexo clean && hexo g && hexo d

线上 CSS/JS 资源加载失败 → 检查 root: 配置是否正确
GitHub Pages 缓存：
- 浏览器刷新 Ctrl + F5 / Cmd + Shift + R
- 等待几分钟 GitHub Pages 更新静态文件

6. 源码与部署分离注意

不要把 public/ 和 node_modules/ 上传到源码仓库，加入 .gitignore：

/public
/node_modules

源码仓库用于多设备同步，部署仓库用于 GitHub Pages 展示

7. 依赖与更新

npm install         # 安装依赖
npm update          # 更新 Hexo 和插件

8. 常见问题与解决

问题	解决方案
本地主题正常，GitHub Pages 不生效	检查 `_config.yml root` 配置，清理缓存后重新生成部署
文章更新不上线	`hexo clean && hexo g && hexo d`，确认 `hexo-deployer-git` 安装正确
多设备冲突	写文章前 `git pull`，写完 `git push`
CSS/JS 不加载	检查浏览器缓存，强制刷新
公共图片或第三方资源加载慢	使用 GitHub 直接托管或图床加速

9. 小技巧

草稿管理：

hexo new draft "草稿标题"
hexo s --draft  # 本地预览草稿
hexo publish draft "草稿标题"

自动化部署（可选）：GitHub Actions，实现 push 源码自动生成并部署
多分支管理：

git checkout -b feature-xxx
git push -u origin feature-xxx

以后直接 git pull / git push 不需要再加参数

这份指南可以作为 你的 Hexo 日常维护备忘，覆盖了从源码管理、文章写作、部署到主题切换和缓存问题的完整流程。

如果你愿意，我可以帮你画一个 直观流程图，把 本地 → 源码仓库 → GitHub Pages 的操作关系可视化，看一眼就懂。

你想要流程图吗？