Astro 初始化小记

makoMakoGo 于 2026-03-15 发布

最近拿一个旧博客主题仓库起了自己的新站,顺手把底座改成 Astro。最大的感受不是“新”,而是“省心”。

起点是什么

这次并不是在我自己已经写了很多年的旧站上做大迁移,而是从一个现成仓库起步。

起点是一个基于 TMaize 风格的 Jekyll 博客仓库。页面靠 Liquid 模板、_layouts_includespages_posts 这些目录拼起来,样式和交互则是一套很克制的极简主题。

这套东西不是不能用。问题在于,它每次想改一点结构,都要先和旧工具链商量一下:

我真正想换掉的,从来不是那种冷静、稀疏、没什么废话的页面风格,而是底层那套已经不太顺手的维护方式。

为什么是 Astro

我没有打算把博客做成一个前端框架展示柜,所以选型时反而更在意“克制”。

Astro 最适合这个仓库的地方,不是它有多新,而是它刚好站在一个很顺手的位置上:

换句话说,Astro 给我的不是“花哨能力”,而是一个更现代、但又不会喧宾夺主的外壳。

怎么平滑接手并改成自己的

这次初始化没有追求推倒重做。我更在意的是先把这个 fork 来的骨架稳稳接住,再把脏的、老的部分一点点换掉。

做法大概是这样的:

这样做的好处是,新站初始化时不会一下子把原来那套辨识度打碎。

打开首页时,还是那个深色背景、左上角圆形头像、右上角横向导航、按年份归档的列表;但往下看代码,已经不再是原来那套 Jekyll 目录和 Ruby 工具链了。

这次最在意的点

我并不想把站点做成一个花里胡哨的产品页,所以迁移时优先保住了这些元素:

  1. 深色背景
  2. 左上角圆形头像
  3. 右上角横向导航
  4. 首页按年份归档
  5. 文章页的极简排版

我并不觉得“现代化”一定意味着做得更满。对博客来说,很多时候少一点花样,反而更耐看。

初始化之后最明显的变化

真正让我觉得舒服的,不是页面突然变酷了,而是后面继续维护时终于不再和旧环境拉扯。

如果后面还要继续折腾,我想补的不是花哨动画,而是: