15022023
← 博客

用 Astro 重建个人站点:为什么放弃 WordPress

一个静态站要解决的问题其实只有三个——写得快、看得快、搬得走。Astro 正好把这三件事都做完了。

约 3 分钟Astro静态站工程实践

这个站点的前一版是 WordPress。它用了两年,最终让我下决心换掉的原因不是慢,而是不敢动:主题改一行 CSS 要担心插件冲突,升级核心要担心白屏,备份是一堆 SQL 和 wp-content 的压缩包——迁一次服务器要整整一个下午,还得重新配一遍伪静态和证书。

静态站把这些问题一次性去掉了。

三个真实需求

抛开“博客”这个抽象词,我实际需要的只有三件事:

  1. 写作要快——打开编辑器,写 Markdown,保存,推送,结束。
  2. 访问要快——手机 4G 下首屏一秒内出来,不要转圈。
  3. 搬家要容易——换个托管商,不能超过十分钟。

WordPress 在 2 上勉强及格,在 1 和 3 上都不及格。而静态站的产物就是一堆 HTML 文件,这三条是天然成立的。

为什么是 Astro

候选其实有三个:Hugo、Hexo、Astro。前两个都很快,但它们的模板语法(Go template / EJS)在需要一点交互的时候会很难受。Astro 的吸引力在于:

  • 内容集合自带类型校验。content.config.ts 里用 Zod 定义 frontmatter,字段写错会在构建时报错,而不是上线后渲染出一个空白页。
  • 默认零 JavaScript。页面里没有交互的部分完全不打包 JS,需要图表时再局部加载。
  • 可以直接写 JSX 风格的组件,需要复杂交互时挂一个 React 岛就够了,不必整站换成 SPA。

这是我这个站的构建配置,短到可以贴完:

// astro.config.mjs
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';
import tailwindcss from '@tailwindcss/vite';

export default defineConfig({
  site: 'https://15022023.xyz',
  integrations: [sitemap()],
  vite: { plugins: [tailwindcss()] },
});

代价是什么

静态站不是没有成本,主要是两点:

  • 没有后台。写文章必须有 Git 和编辑器。对我不是问题,对想在地铁上用手机发文章的人是硬伤。
  • 评论和搜索要自己接。评论用 giscus 挂 GitHub Discussions,搜索用 Pagefind 在构建期生成索引,都是纯前端方案,不用服务器但需要各配一次。

如果这两点能接受,静态站几乎没有理由不选。

迁移成本

文章的源文件是仓库里的 src/content/blog/*.md,投研数据是 src/data/snapshot.json。换托管商时执行:

git clone <repo> && cd site
npm ci && npm run build

产物在 dist/,扔到任何能托管静态文件的地方就能跑。这是我从 WordPress 迁移过来最大的收益——内容不再和运行环境绑死。