把旧站表格里的文章一次导入，字段对应不上怎么办

旧站导出的表格要批量导入新系统，字段对不上是常态而不是异常，处理方式有固定顺序：先决定用哪种通道，再把必映射列固定下来，然后为对不上的自定义字段定缺省值策略，最后用按标题查重的能力避免重复导入。跳过第一步直接改表格，通常会改两轮。

先选通道再谈映射

批量导入支持两条通道：ZIP 压缩包和 Excel 表格。两者的分工不同，不是二选一的关系。

选择通道之后再做映射，是因为两条通道能带的信息不同：压缩包能带附件与文件对应关系，表格只能带列里的内容。先改表格再发现附件缺失，就要重来。

必映射的三列

无论旧站结构多乱，先把这三列固定下来：标题、别名、分类。

标题决定文章身份，也决定后续按标题查询是否已存在能不能命中；别名决定线上地址，别名映射错了会导致导入后地址变化，进而影响历史链接和收录；分类决定页面归属和列表页呈现，分类对不上时文章虽在却找不到入口。

这三列之外都可以先留空，但不要在这三列上做妥协。旧站的栏目名与新站分类名不一致时，应当先做一张名称对照表，而不是让导入去猜。

自定义字段对不上怎么处理

自定义内容模型支持灵活的内容结构，字段是可以按站点定义的，所以「旧站有、新站没有」的字段有两种处理方式：其一是在新站补一个自定义字段来承接，适合这个字段后续仍要参与展示或筛选；其二是把内容并入正文，适合只是补充说明的信息。

判断标准是它要不要被单独读取。需要被列表筛选、需要参与模板标签输出的，走字段；只是给人看的，进正文。

对不上的字段还要定缺省值策略：留空、给固定值、还是从正文里提取。这一条要事先写在导入说明里，否则批量导入的结果里会出现一半空值一半乱值。删除的内容仍可进回收站恢复，但导入错乱的批量数据清理起来比恢复更费时间，所以宁可先在测试批次上跑一遍。

重复标题与导入后核对

批量导入最容易出的问题是重复。文档内容导入接口 /api/import/archive 支持按标题查询是否已存在，这一能力的正确用法是在写入前先查一次：命中的走更新或跳过，未命中的才写入。把查重放到导入之后，就变成了先制造重复再清理。

导入后的核对按三步抽样：随机抽几篇核对标题与别名是否与表格一致；核对分类归属是否正确；核对带附件的文章附件是否落地。抽样量不必大，但要覆盖字段对不上的那几类，因为问题总是集中在边界上。

常见问题

Excel 表格导入支持哪些列

支持把列映射到标题、别名、分类等基础字段与自定义字段。关键是列名与新系统字段的对照要事先定好，未对照的列会被忽略。

带图片的文章用哪种方式

用 ZIP 压缩包。附件与正文在同一批次内，能保持对应关系；表格通道只能表达文本列。

导错了怎么回退

单篇删除可以进回收站恢复；批量错乱建议按批次重新导入前先查重，配合按标题查询是否已存在来决定跳过还是写入，比事后逐篇清理更省时间。

旧站字段比新站多怎么办

按是否要被单独读取分流：要参与筛选和展示的补成自定义字段，只作说明的并入正文，无实际用途的直接丢弃。