批量导入文章用压缩包还是表格，两种格式各适合什么场景

批量导入文章选压缩包还是表格，取决于内容是否带文件。带图片、附件、模板资源的内容用 ZIP 压缩包更合适，一次把正文与随附文件带进去；字段规整、条数很多的表格式内容用 Excel 表格更省事，栏目、标签、发布时间可以直接按列填。AnQiCMS 的批量导入文档同时支持 ZIP 压缩包和 Excel 表格两种方式，另有导入接口可供程序化对接。

ZIP 适合带附件的内容

压缩包的价值在于「一篇文档和它的文件是一个整体」。从旧站导出的文章通常带若干图片与下载附件，逐篇手工补图很容易漏，也能导致链接指向已经不存在的文件。用 ZIP 时按一文档一目录组织，正文与资源同名放置，导入后附件关系保持完整。适合的场景包括：整站迁移、带产品手册或图纸的技术文档、以及含下载资料的报告类内容。

要留意压缩包体积。附件多时单次上传容易碰到限制，更稳的做法是按栏目分卷，每卷控制在可重传的规模，失败时只需重传那一卷而不是全部重来。

Excel 适合结构化字段批量

表格方式适合字段多、正文短的批量内容，例如问答条目、术语表、门店与联系方式列表。它的优势是可以在表格里先做校验与去重，导入前就能看到空标题、重复行、日期格式不一致这些情况。适合的场景包括：结构化条目初始化、批量补字段、以及需要与运营同事共同维护的清单。

常见失败点集中在编码与日期：日期列被存成文本、编码不同导致中文乱码、标题里带多余空格让查重判错。导入前把这几列格式统一，比事后逐条修效率高得多。

导入前先按标题查重

两种格式都需要一步前置检查：这批内容与站内已有文档是否重名。重复导入的代价不只是多几条草稿，而是同一主题出现两份正式内容，分散权重还让后续更新不知道改哪一份。AnQiCMS 提供的文档内容导入接口 /api/import/archive 支持按标题查询是否已存在，先查后写就能把重复挡在门外；程序化对接时，把「查标题—不存在才建—存在则跳过或更新」写成固定顺序，比一次性全量提交更容易控制。

导入失败的恢复路径

导入出错时，先判断影响面。如果只多了重复文档，走回收站即可：删除正式文档是移入回收站而不是物理删除，误删可恢复，这也意味着清理重复内容时不必担心删错就找不回。如果导入改动了既有内容，例如批量覆盖了字段，就应当用备份与恢复回退——AnQiCMS 的备份覆盖数据并包含静态文件，可以整体回到导入前的状态。前提是备份在导入之前就已存在，所以习惯上把「先备份，再批量写入」固定成流程顺序，而不是出事后才找备份。

接口批量导入的用法

规模大、需要反复执行的导入更适合走接口：先按标题查询是否已存在，再提交归档内容，避免把重复判断交给人工。接口方式还能与来源系统对接，把每天新增条目持续导入，配合定时发布控制上线节奏。需要注意的是执行频率与批次大小，大批量任务安排在业务低峰，留出观察时间，出现问题时容易定位是哪一批引起的。

常见问题

能不能混用两种方式？ 可以。常见做法是用 ZIP 迁移正文与附件，再用表格批量补齐分类、标签等字段，两类格式解决的是不同问题。

导入后图片显示不出来，通常是什么原因？ 多是资源文件没有随正文一起进入，或目录层级变化导致路径对不上。用压缩包按原结构重导一遍，比重建图片关系更快。

表格能一次导多少条？ 按批次导，而不是把全部条目压成一次提交。分批次便于校验，也便于出错时定位。