博客搭建过程记录（Hexo + Butterfly）从动机、搭建、美化到部署与后续维护

本文是对个人博客搭建与日常维护流程的系统整理，方便后续复盘与迁移到其它设备。内容包括动机、框架选择、主题美化、部署策略、写作流程、常用命令以及潜在问题展望。

1. 搭建的目的

本科阶段就有“做一个属于自己的网站 / 知识库”的想法，但迟迟没有行动。求职阶段回顾过去：学了很多，也似乎留不下系统沉淀。于是决定用博客持续记录——聚焦于学习轨迹、踩坑经验、与阶段性总结。

2. 总体搭建用时与感受

网上教程非常多，原本担心复杂度较高，实际两天左右就完成了一个可用的初版。当前定位：个人学习记录，不追求花哨功能，后期只做轻量迭代（样式与体验微调）。

3. 技术栈与主题美化

  • 框架：Hexo
  • 主题：Butterfly
  • 美化动作：
    • 调整主题主色与背景图片
    • 自定义个人简介页面（借助 GPT 快速生成前端结构）
    • 优化导航栏结构（首页 / 分类 / 标签 / 关于）
    • Tag 页面与 Category 页面样式微调

4. 域名与部署策略选择

起初考虑买服务器（例如阿里云）自行部署，但：

  1. 额外运维成本与时间投入不划算
  2. 博客主要是“自用记录”，对性能与动态能力需求低
  3. 服务器费用不必要

最终选择 GitHub Pages 部署，另购国内域名以减少访问翻墙需求。当前体验：

  • 缺点：图片首次加载稍慢
  • 优点：免服务器、配置简单、可持续维护

5. 源码备份策略

担心只放 GitHub Pages 最终生成内容，一旦本地源文件丢失难以恢复。策略：

  • 建立一个私人仓库存放 Hexo 源文件（source/、配置、主题定制等）
  • 每次写新文章：生成、部署后，再推送源码仓库保持同步

虽然步骤多一点，但可用性与安全性更高。

6. 当前写作与发布流程

写新博客的操作顺序：

  1. 在 source/_posts/ 下新建 Markdown 文件（建议文件名：YYYY-MM-DD-主题.md）
  2. 准备封面或插图放到 source/img/（或主题要求的 img/ 目录）
  3. 在 themes/butterfly/_config.butterfly.yml 中（必要时）配置背景或封面引用
  4. 本地预览或直接生成 + 部署

7. 常用命令合集

分步骤执行：

1
2
3
4
5
6
7
hexo clean      # 清理缓存与旧的 public 文件
hexo g          # 生成静态文件 (hexo generate)
hexo d          # 部署到 GitHub (hexo deploy)

git add .
git commit -m "update"
git push        # 推送源码到私人仓库

一行整合版本：

1
hexo clean && hexo g && hexo d && git add . && git commit -m "update" && git push