不少老博客还跑在 WordPress 上，用了七八年，插件越装越多，后台越来越卡。静态站点生成器这条路这两年越走越宽，Astro 在 GitHub 上的 star 已经涨到六万三，最近一周还有近两百的增量，说是内容型站点框架里增长最快的一个不为过。如果你正琢磨把博客搬过去，这篇讲讲迁移路上几个容易摔跤的地方。
图片由 AI 生成
动手前先想清楚要不要搬
先泼一盆冷水。WordPress 的价值在于动态功能：评论、搜索、表单、会员，装插件就有。搬到 Astro 之后这些都是静态的，要么接第三方服务，要么自己写接口。如果你的站依赖这些动态能力，搬过去反而添堵。适合搬的是那类内容为主、更新频率不高、对速度敏感的博客和文档站。
判断标准很简单：过去一年你用过几次后台的动态功能？答案是零，迁移收益就是实打实的——静态页面的加载速度和维护成本，PHP 站没法比。
第一步：内容导出别丢格式
WordPress 的导出功能给的是一个 XML 文件，里面是全部文章、页面、评论和媒体信息。转到 Astro 要的是 Markdown，中间需要一次转换，社区有现成的转换脚本可用。这一步最容易出问题的是短代码和复杂排版：文章里用过的短代码、表格、嵌套列表，转出来经常变形，要逐篇检查。
媒体文件的路径也得处理。WordPress 的图片挂在 wp-content 目录下，迁移后路径全变了。建议转换脚本里顺手把图片引用统一改成 Astro 的资源目录结构，别迁完文章再回头挨个找坏图。
第二步：URL 结构就是 SEO 生命线
这是整个迁移里最要命的一步。老站的文章在搜索引擎里都有收录，URL 一变，收录清零重来。Astro 的路由是文件结构决定的，规划内容目录时先把老站的固定链接格式抄下来，让新站的路径和老站完全一致。
实在对不齐的部分，用托管平台的重定向规则兜底，旧 URL 永久重定向到新地址。迁完别急着收工，拿站点地图和搜索引擎的收录记录对一遍，把 404 清干净，这一步偷懒，前面全白干。
图片由 AI 生成
第三步：把动态功能安置好
评论是博客搬家的头号缺口。Astro 本身不管评论，主流做法是接 giscus 这类基于代码仓库讨论区的方案，或者用第三方评论服务，几分钟配好，垃圾评论治理还省心。站内搜索用客户端方案，内容量在一两千篇以内，页面加载后本地索引检索，体验完全够用。
表单类需求接一个无服务器函数就能解决。这些服务各有免费额度，个人博客的流量基本花不到钱，但要把数据主权想清楚：评论数据存在别人那里，将来再迁移又是一轮折腾。
迁移后的验收清单
搬完做四件事：全站 404 扫一遍，确保旧链接都有去处；用测速工具对比迁移前后的加载时间，确认收益达到预期；检查结构化数据和站点地图是否完整生成；最后把老站的数据备份留好，留三个月再下线，给自己留退路。
迁移本身不难，Astro 的内容集合和 Markdown 工作流对写作者很友好，难的是细节的完整度。按上面的顺序走，预留一个周末的时间，多数个人博客都能平稳搬完。
