先说结论
我把博客从 Next.js + Velite 换成了 Astro 7,用的主题是 astro-koharu。
换完之后这个站是纯静态的:构建产物就是一堆 HTML、CSS、JS,没有服务端、没有数据库,扔到任何静态托管上都能跑。这对一个只想安安静静写字的人来说,比什么都重要。
但这篇文章真正想说的不是技术选型,是感谢。
要感谢的第一个人:mk965
我最早的这个博客,骨架来自 mengke.me。
那时候我刚开始折腾个人博客,什么都不懂。GitHub 上翻了几十个项目,最后停在这个上面——它把 Next.js、Tailwind、MDX、搜索、评论、SEO 这些东西全都搭好了,而且写得很清楚,我能一行一行看明白它在干什么。
我的第一篇文章《从零到一:一个高中生的博客搭建与优化之旅》里写过,我是怎么找到这个模板、怎么照着改的。现在回头看那篇,字里行间全是一个新手的兴奋和手忙脚乱。
没有 mengke.me 这个起点,就没有后来这一路。 后来我在它上面加了自己的东西:液态玻璃设计、照片墙、碎碎念、项目页、Changelog…… 从一个模板慢慢长成一个”我的”博客。
要感谢的第二个人:cosZone
换框架的时候,我又一次面临”从零开始”。
这次运气好,找到了 astro-koharu——一个用 Astro 7 + Tailwind 4 + React 写的博客主题,设计灵感来自 Hexo 的 Shoka 主题。
它打动我的地方,不只是好看:
- 质量高得离谱。它不是”能跑就行”的模板,加密文章用 AES-256-GCM 真正做构建期加密、代码块有折叠和行标记、链接自动生成 OG 卡片、支持从 Shoka 迁移过来的一整套 Markdown 扩展语法。这些细节说明作者是真的在自己用。
- 工程化完整。自带 CLI(备份、还原、主题更新、内容生成)、完整的测试套件、i18n 多语言、Pagefind 搜索、giscus / Waline / Twikoo / Remark42 四种评论系统可选。
- 文档足够细。
AGENTS.md、GETTING-STARTED.md、docs/features/——一个主题能写到这个程度,是花了大量时间的。
而且它是 AGPL-3.0 开源的。这意味着我可以直接拿来用、改,只要把改动也开源出去。
谢谢你把这么多工作成果直接放出来。 我知道维护一个高质量开源项目有多耗精力,尤其是还带着完整文档和测试的那种。
为什么换框架
不是为了追新。是真的有几个问题绕不过去:
第一,我要的是纯静态。
原来的 Next.js 方案虽然也能 export 出静态站,但整个技术栈是围绕服务端渲染设计的,写完总觉得别扭。Astro 是”默认零 JS”的思路,一个博客 90% 的页面本来就只是文章,不需要一坨水合。换成 Astro 之后,构建产物是纯静态的,部署到任何地方都不用操心运行时。
第二,内容管理太重了。 原来用 Velite 做内容层,配置文件写了一百多行,每次改 schema 都要重新理解一遍。Astro 的 Content Collections + Zod schema 更直接:文章就是带 frontmatter 的 Markdown,字段定义一目了然。
第三,我不想再维护一堆自己写的基础设施。 搜索、评论、图片优化、SEO、RSS、站点地图……这些东西我自己拼过一遍,能用,但每次升级依赖都要重新调。astro-koharu 把这些都做好了,还带测试。把精力放在写字上,比放在修基础设施上值。
第四,迁移成本比想象中低。
九篇文章、几百张图、一堆内链,理论上很麻烦。实际上写个转换脚本,把 frontmatter 映射一下、内链 /blog/xxx 改成 /post/xxx、MDX 组件换成 Markdown 容器语法,一天之内就跑通了。文章是 Markdown,它本来就不该被框架绑死——这也是我这次最深的体会。
现在这个站
- 框架:Astro 7,纯静态输出
- 主题:astro-koharu(AGPL-3.0,已保留原许可与署名)
- 内容:Markdown + Content Collections
- 搜索:Pagefind(构建期生成索引)
- 评论:giscus(GitHub Discussions)
- 部署:Vercel,推送到 GitHub 自动构建
- 备案:萌ICP备20263777号
最后
写博客这件事,我做了不到一年。技术上没什么值得炫耀的,我到现在还是靠 AI 帮我写代码。
但有一件事我越来越确定:你今天能轻松用上的东西,是别人花了很多个晚上做出来的。
mk965 和 cosZone 都不认识我,他们只是把自己的项目开源了。但这个动作,让一个桂林的文科生能在大学宿舍里搭起自己的博客,能一行一行看懂、能改、能学。
所以这篇不是技术文章,是记账。记下我欠了谁的人情。
如果以后我也有能力做出点什么,希望能像他们一样,直接放出来。
感谢阅读。这个博客会继续写下去。
마음에 드신다면, 댓글을 남겨주세요~