从 WordPress 到 VitePress

为什么迁移

WordPress 用了 5 年，文章 200+ 篇。迁移的导火索是：

1. 后台越来越卡，加载 5+ 秒
2. 主题系统复杂到改一个样式要改 5 个文件
3. 插件质量参差不齐，安全漏洞频发

VitePress 的好处：

• 内容即代码——所有内容是 Markdown 文件，frontmatter 驱动
• 零数据库——纯静态，可托管在任何 CDN
• 构建快——Vite 冷启动 < 1s
• 可定制——Vue 组件 + 自定义 Layout，想怎么改就怎么改

迁移步骤

1. 用 wordpress-export-to-markdown 把文章导出为 .md
2. 清理媒体资源，保留必要的图片到 public/
3. 写 VitePress 配置 + 自定义 Layout
4. 一篇一篇校对 frontmatter（标题、日期、标签、分类）
5. 部署到 EdgeOne Pages
6. WordPress 设置 301 重定向到新域名

踩过的坑

• WordPress 导出的代码块高亮 class 名不规范，要批量替换 lang-php 为 php 等
• 图片相对路径失效——WordPress 的 /wp-content/uploads/ 路径全部要重新映射
• 评论系统迁移——从 WordPress 原生评论迁移到 Twikoo，需要重新激活
• RSS 输出字段不一致——WordPress 的 RSS 包含完整全文，需要确认新站 feed.xml 也有

最终架构

Markdown 内容
   ↓
VitePress 构建
   ↓
docs/.vitepress/dist
   ↓
EdgeOne Pages CDN
   ↓
用户

构建一次只需要 8 秒（vitePress 增量构建），全站部署 30 秒。

总结

博客迁移本质上是把"内容管理系统"换成"内容即代码"。前期投入大（一次性导数据），但后续维护成本极低（改一行 commit 一下就完事）。

如果你也想迁移，建议先小范围试点（比如只迁 5 篇文章），验证流程跑通再大批量。