再见 Jekyll,你好 VitePress 原创
背景
2025 年 7 月,我偶然间看到了黄玄的博客,第一次知道原来可以用 GitHub 搭建个人站点。
彼时,各式各样的静态网站框架令我眼花缭乱。为图方便,我选择直接 fork 黄玄的仓库,在它的基础上进行二次开发。
但我此前从未接触过相关技术,对博客底层 Jekyll 也毫无了解。而黄玄的项目经过了高度定制,不深入学习了话,我几乎是寸步难行。
最终,我只做到了:
- 抹除原博客的文字内容
- 汉化部分界面
- 添加了两篇文章:
做完这些,这个博客就被搁置了。
转机
2026 年 3 月,因为模组文档站点的需求,我接触到了 VitePress。这次在技术选型时,它基于 Vue 3 + Vite,正好是我熟悉的技术栈。我用它搭建了两个静态站点,对基本用法和技术框架有了比较深入的了解。
这件事让我重新想起了那个被搁置的博客。
2026 年 4 月底,在对比了多个基于 VitePress 的博客主题后,我选择了 Teek。相比其他主题,它的完成度更高、功能更完善,多种主题配置界面我也很喜欢。最重要的是,它让我几乎不需要折腾源码就能得到一个完整的博客。
迁移
2026 年 5 月 14 日,我完成了从 Jekyll 到 VitePress 的迁移。
这个博客搭建的初始步骤记录在 VitePress 博客搭建。
部署期间,我做了自定义改造——添加了文章底部的版权声明、文章Banner横幅背景图作者声明等等。具体的改造项目记录在 Teek 主题自定义 里。
另外,为了方便以后写文章时快速复用 Frontmatter 配置,我还整理了一份 Frontmatter 常用模板,有需要可以自取。
展望
回头来看,这次迁移的意义不只是换了一个框架。
第一次搭博客时,我为了"快"而选择了完全不了解的技术,结果快不起来。这次我选择了自己熟悉的 Vue 生态,反而每一步都走得很踏实。
工具永远是服务于人的。选对工具的前提,是清楚地知道自己能用好什么。
接下来,我会在这里继续写模组开发、写生活经验、写一些有的没的。
感谢你看到这里,欢迎常来逛逛❤。