批量导入用压缩包还是表格，两种来源各自适合什么场景

批量导入用压缩包还是表格，两种来源各自适合什么场景，判断点在于内容是连着资源一起走，还是先立住结构再补正文。AnQiCMS 的批量导入支持 ZIP 压缩包和 Excel 表格两种来源：压缩包可以把正文连同图片等资源文件一起进站，表格面对的则是结构化字段，适合先把条目批量建起来再逐条补内容；此外还有一条接口路径可用。

ZIP 压缩包和 Excel 表格的能力边界在哪？

压缩包的长处是整体性。迁移往往既有正文也有正文引用的图片，打成包送进来，正文和资源在同一批动作里落地，免去内容与素材分家的麻烦；代价是映射关系藏在包内结构里，包越大，出问题时越需要逐层拆开核对。

表格的长处是结构化。列对应字段，一行对应一条内容，标题、摘要、分类归属适合批量排布。AnQiCMS 支持自定义内容模型，内容结构可按业务灵活搭建，自定义字段多的站点会在表格里把列与字段的对应关系排清；边界是不承载正文之外的素材，图片要另行安排进站。

三条来源的差别怎么看？

两种来源怎么选？

栏目整搬、正文强依赖图片或其他素材的，用 ZIP 压缩包更省事，内容和素材在同一次动作里进站。站点内容结构复杂、自定义字段多，而正文可以后续慢慢补的，Excel 表格更合适：先把条目、字段值、分类归属批量立住，再按优先级回填正文。

需要由外部程序或旧站脚本分批送内容的，走接口这条路径。AnQiCMS 提供文档内容导入接口 /api/import/archive，支持按标题查询内容是否已存在，用于批量导入。它的实操含义是去重：中途失败重跑时先查标题，再决定这条是否还要送，避免同一标题进站两次。接口涉及哪些参数、能不能带资源，属于方案里要确认清楚的边界。

导入前要准备什么？

其一是字段映射表。旧字段到新字段的对应关系逐列写清，尤其是自定义字段：哪列进哪个字段、空值怎么处理、格式约定是什么，导入前定稿，导入后才有比对基准。其二是别名规则。别名决定页面在站内的指向，批量进站容易出重复或无规则可查的随机串，要事先定生成规则。其三是分类归属。每条内容归到哪个栏目写进映射表，别让内容进站后再手工挪位置。

导入后必查的四项是什么？

一是分类：抽样打开新进站的内容，确认落在预期栏目、列表位置正确。二是别名：核对是否符合规则、有无重复，这直接关系到链接稳定性。三是图片落位：压缩包路线要确认资源确实进站并在正文里正常显示，表格路线要确认没有留下指向不到资源的空引用。四是是否需要重推链接：站内若还有指向这些内容的旧链接或列表入口，逐条访问确认落点有效，必要时把新指向同步过去。

批量导入怎么和定时发布错开？

AnQiCMS 支持时间因子中的定时发布，可以设定内容在指定时间发布。迁移里这既是便利也是风险：批量导入与定时发布挤在同个时间窗口，等于把大量内容压在同时刻放出，出问题也难判断是导入还是发布环节导致的。稳妥的做法是把两者拆开，导入阶段先进入可控状态，再按栏目或主题分批安排定时发布，让放出节奏与核对节奏对上。

常见问题

压缩包和表格能混着用吗？ 可以按范围分开：结构与自定义字段走表格，带资源的正文走压缩包。前提是先定好映射表和归属规则，避免同一条内容从两个入口各进一次。

表格导入能带图片吗？ 表格承载的是结构化字段，图片不靠它进站，需要在导入安排之外单独处理，导入后按图片落位这项核对正文引用是否有效。

怎么避免重复导入？ 按标题先查再送。/api/import/archive 支持按标题查询内容是否已存在，把这步做在每条动作之前，重跑批次时就不会把同题内容送两遍。

导入后还要人工检查吗？ 要。分类、别名、图片落位、旧链接指向四项都要人工抽样核对，导入动作只负责把内容送进来，这几点是否合格不在它的判断范围内。