从 mock 数据迁移到真实内容文件的完整做法

Tutorial Path

内容系统系列

当前位置：04 / 04

从原型阶段顺利跨到正式内容系统，而不是推倒重来。

原型阶段用 mock 数据没有问题，问题出在很多项目迟迟没有完成这次迁移，结果页面逻辑、内容结构和临时假数据越缠越紧。到了想认真写内容的时候，才发现整个站点的生产方式并不适合长期维护。

迁移的第一步不是复制内容，而是先打通读取链路

如果你在 reader、schema、slug 规则都还没稳定的时候就把所有内容迁过去，后面很可能又要二次迁移。我更推荐先做一条最小可用链路：真实文件能被读取、frontmatter 能被校验、详情页能被渲染、列表页能按日期稳定排序。

链路通了以后，再把 mock 内容一批批搬进来，风险会小很多。

mock 数据应该被视为“素材草稿”，而不是事实来源

迁移时最容易犯的错误，是把 mock 里的所有字段都当成正式数据照搬过去。其实很多原型字段只是为了撑页面，未必值得进入正式内容结构。更好的做法是保留意图，重写结构：哪些信息应该进入 frontmatter，哪些应该留在正文，哪些干脆删掉。

迁移完成的标志是什么

对我来说，迁移真正完成有三个标志：

1. 页面已经不再依赖 mock 源。
2. 新增内容只需要向 content/* 写文件，不需要再改代码数组。
3. 后续搜索、SEO、RSS、分类等能力都统一建立在真实内容源上。

一旦这三点成立，内容系统就算从“演示模式”跨到了“生产模式”。

小结

迁移不是一次性搬运，而是一次从临时表达过渡到稳定生产的系统改造。内容系统系列到这里就结束了。接下来我们进入 App Router 支线，把路由、布局和渲染边界拆得更细。