缘起

折腾了一个下午，终于把这个博客搭起来了。

过程比想象中顺利，也比想象中坑多。趁热把踩过的坑记下来，免得以后忘了。

技术栈

环节 选型 说明
静态站点生成器 Hexo 7.0 基于 Node.js，Markdown 写作
主题 Butterfly 5.7 中文生态最活跃的 Hexo 主题
代码托管 Gitee 国内访问快
部署 待定 Gitee Pages 已下架，改用替代平台

一个重要的教训

网上的教程有很强的时效性。我照着 2021 年的文章操作，卡在了”开启 Gitee Pages 服务”这一步——这个功能 2025 年 10 月已经下架了。

搜索结果里的答案往往互相矛盾，最靠谱的做法是直接查官方文档或官方 issue。

接下来要做的

  • 本地跑通 Hexo
  • 换上 Butterfly 主题
  • 部署到线上
  • 绑定自己的域名

慢慢来，先把内容写好。