Aronnax's Blog
0%

memorandum generated by ChatGPT

发表于 更新于

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

1. 仓库结构

源码仓库（blog_backstage）

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

发布仓库（username.github.io）

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

2. 常用命令

本地开发

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 本地启动预览
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  # 拉取最新更新

查看远程仓库

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

3. 多设备操作流程

  1. 新设备克隆源码
1
2
3
git clone https://github.com/yourusername/blog_backstage.git
cd blog_backstage
npm install
  1. 日常写作流程
1
2
3
4
5
git pull                  # 同步最新源码
hexo new post "文章标题"
hexo s                     # 本地预览
hexo clean && hexo g && hexo d  # 生成并部署到 GitHub Pages
git add . && git commit -m "更新文章" && git push

4. 主题管理

  1. 下载主题到 themes/ 文件夹
1
2
cd themes
git clone 主题仓库地址 主题名
  1. 修改 Hexo 配置 _config.yml：
1
theme: 主题名
  1. 主题自带配置
  • 打开 themes/主题名/_config.yml 修改颜色、菜单、评论等
  1. 重新生成部署
1
2
3
hexo clean
hexo g
hexo d

5. 部署注意事项

  • _config.yml 的关键配置：
1
2
url: https://yourusername.github.io   # 根仓库
root: /                               # 根路径 / 或子目录 /blog/
  • 主题/插件修改后一定要：
1
hexo clean && hexo g && hexo d

  • 线上 CSS/JS 资源加载失败 → 检查 root: 配置是否正确

  • GitHub Pages 缓存：

    • 浏览器刷新 Ctrl + F5 / Cmd + Shift + R
    • 等待几分钟 GitHub Pages 更新静态文件

6. 源码与部署分离注意

  • 不要把 public/ 和 node_modules/ 上传到源码仓库，加入 .gitignore：
1
2
/public
/node_modules
  • 源码仓库用于多设备同步，部署仓库用于 GitHub Pages 展示

7. 依赖与更新

1
2
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. 小技巧

  • 草稿管理：
1
2
3
hexo new draft "草稿标题"
hexo s --draft  # 本地预览草稿
hexo publish draft "草稿标题"

  • 自动化部署（可选）：GitHub Actions，实现 push 源码自动生成并部署

  • 多分支管理：

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

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

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

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

你想要流程图吗？