用 Astro 重建个人站点:为什么放弃 WordPress
一个静态站要解决的问题其实只有三个——写得快、看得快、搬得走。Astro 正好把这三件事都做完了。
约 3 分钟Astro静态站工程实践
这个站点的前一版是 WordPress。它用了两年,最终让我下决心换掉的原因不是慢,而是不敢动:主题改一行 CSS 要担心插件冲突,升级核心要担心白屏,备份是一堆 SQL 和 wp-content 的压缩包——迁一次服务器要整整一个下午,还得重新配一遍伪静态和证书。
静态站把这些问题一次性去掉了。
三个真实需求
抛开“博客”这个抽象词,我实际需要的只有三件事:
- 写作要快——打开编辑器,写 Markdown,保存,推送,结束。
- 访问要快——手机 4G 下首屏一秒内出来,不要转圈。
- 搬家要容易——换个托管商,不能超过十分钟。
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 迁移过来最大的收益——内容不再和运行环境绑死。