WordPress 迁移至 EmDash 指南
通过分阶段导入、媒体校验与清晰的自定义内容规划，将 WordPress 站点迁入 EmDash。
从 WordPress 迁到 EmDash，若先把迁移当作内容与 schema 项目，而不是「复刻主题」，会轻松很多。先让内容过来、校验媒体与结构，再在数据模型稳定后处理自定义渲染与设计一致。
开始之前
在运行任何导入前，先弄清要迁的是哪类 WordPress 站点。
建议先梳理：
- 标准文章与页面
- 媒体附件
- 自定义文章类型
- 自定义字段与编辑元数据
- Gutenberg 区块或短代码密集的内容
原因很简单：简单发布型站点往往导入较干净；而重度依赖自定义区块、插件生成字段或特殊前台渲染的站点，导入后通常还需要第二轮实现。
导入选项
将 WordPress 内容迁入 EmDash，有两种合理路径。
WXR 导出
若希望基于文件的迁移流程，使用 WXR 导出。
通常更适合：
- 需要可携带的导出物
- 多人需要审阅或归档源导出
- 希望在源数据与目标校验之间划清边界
典型流程：
- 打开 WordPress 后台。
- 将站点内容导出为
WXR文件。 - 在 EmDash 中用该导出启动导入。
- 检查导入后的条目与媒体。
EmDash Exporter 插件
若希望从在线 WordPress 实例直接拉取，使用 EmDash Exporter 插件。
典型流程：
- 在 WordPress 站点安装该插件。
- 配置其提供的安全导出端点。
- 使用 WordPress 应用程序密码保护访问。
- 从该受保护源向 EmDash 执行导入。
当源站仍在日常维护、且你希望直接拉取而非来回传文件时，这条路径更合适。
推荐顺序
对多数团队，较稳妥的顺序是：
- 准备好接收内容的 EmDash 站点。
- 选定一种导入方式并完成首轮迁移。
- 确认条目与媒体是否到位正确。
- 对不应长期停留在「通用编辑内容」上的内容，建立合适的 EmDash 内容类型。
- 仅在导入后的内容结构可信后，再重建自定义渲染。
这样可以把最高风险的工作推迟到数据已在 EmDash 中可见、可审之后。
导入后的校验
不要用「导入是否跑完」评判迁移，而要看导入后的内容是否可用。
首轮校验应检查：
- 文章与页面数量是否符合预期
- 附件媒体是否已进入 EmDash 媒体库
- 标题、正文与发布元数据是否合理
- 编辑侧的关系在导入后是否仍说得通
此阶段请克制先修视觉的冲动。若内容模型仍不对，设计工作会变成昂贵的返工。
自定义内容
WordPress 站点常会超出默认 Post 与 Page 模型。若使用自定义文章类型，迁移时应视为 schema 决策，而非版式问题。
在 EmDash 中，更稳妥的做法是为「值得独立结构」的内容建立原生内容类型。通常要审视：
- 哪些内容仍作为标准编辑条目
- 哪些应成为独立的 EmDash 集合
- 哪些字段应显式建模，而不是隐式塞在正文里
迁移质量往往在此分高下。技术上导入可以成功，但若所有形态都被压成通用条目，EmDash 侧仍会显得很弱。
区块与定制渲染
自定义区块要有意识地区分处理。若旧站依赖定制 Gutenberg 区块、短代码布局或插件特有渲染，请预期后续工作。
合理做法是：
- 先导入底层内容
- 识别迁移后仍需保留的渲染模式
- 用 EmDash 原生工具与组件重建
若需复刻定制区块行为，可从 EmDash Block Kit Agent Skill 入手。
实用检查清单
可作为工作用迁移清单：
- 在 WordPress 中审计文章、页面、媒体与自定义文章类型
- 决定
WXR与 EmDash Exporter 插件哪条导入路径更合适 - 准备目标 EmDash 站点
- 执行首次导入
- 校验媒体迁移与条目完整性
- 在需要处创建原生 EmDash 内容类型
- 标出需要第二轮实现的自定义渲染
- 在尝试视觉一致前，先审内容结构
仍需单独规划的部分
即便导入路径很顺，仍有一些工作落在导入器之外：
- 重定向
- SEO 一致性检查
- 字段清理
- 自定义渲染一致
- 回滚与上线节奏
导入把内容放进 EmDash，并不能替代编辑审阅、schema 决策与上线纪律。