为什么迁移到 EmDash
EmDash 基于 Astro 构建，生成的页面加载速度极快，服务器资源占用低，安全性更高（无 PHP 运行时）。同时保留了 WordPress 用户熟悉的管理后台体验：所见即所得编辑器、分类与标签、媒体库、用户管理等功能一应俱全。
导出 WordPress 数据
在 WordPress 后台的「工具 > 导出」中选择「所有内容」导出 XML 文件。该文件包含文章、页面、分类、标签、评论和媒体元数据。如果站点内容量很大，建议分批导出（按文章类型或日期范围）。
使用迁移工具转换数据
EmDash 提供官方迁移工具 npx emdash migrate wordpress export.xml，自动将 WordPress XML 转换为 EmDash seed.json 格式。工具会将 HTML 内容转换为 Portable Text、保留分类和标签关系、提取特色图片引用。
迁移媒体文件
迁移工具会列出所有引用的媒体文件 URL。使用 --download-media 选项可自动下载所有媒体文件到本地。对于使用 S3 或 Cloudflare R2 等对象存储的场景，可以配置迁移工具直接上传到目标存储。
内容校验与修复
迁移完成后运行 npx emdash seed seed.json --validate 检查转换结果。常见需要手动修复的问题包括：短代码（Shortcodes）无法自动转换、某些复杂 HTML 布局需要调整、嵌入内容需要安装 Embeds 插件。迁移工具会生成详细的报告列出所有需要注意的项目。
URL 重定向设置
WordPress 默认的 URL 结构（如 /2024/01/post-title/）与 EmDash 不同。迁移工具会生成重定向规则文件，配合 SEO 插件的重定向管理功能，确保旧链接能正确跳转到新地址，避免搜索引擎排名损失。
迁移评论数据
WordPress 的评论数据会被转换为 EmDash 的评论格式，保留评论者信息、评论时间和嵌套回复关系。迁移后在 EmDash 管理后台即可继续管理评论。
上线检查清单
切换域名前务必确认：所有内容已正确迁移、重定向规则已配置、sitemap 已生成、RSS 订阅源 URL 已更新（或设置了重定向）、第三方服务（如 Google Analytics、Google Search Console）已更新为新站点地址。建议先在子域名上测试运行一周再正式切换。
