压缩包和表格两种批量导入，图片与字段对不上时先查哪边

压缩包和表格两种批量导入，图片与字段对不上时先查哪边？先查表格这一边。字段是索引，图片是引用，引用找不到通常是因为索引建错了：列名没对齐自定义字段、图片文件名和表格里的引用名不一致。把表格侧确认清楚再看压缩包，能避免把同一批文件反复重传。AnQiCMS 同时支持 ZIP 压缩包和 Excel 表格两种批量导入，两种通道带进来的数据类型不一样，排查顺序也就有差别。

两种导入各自带进来什么

把内容从历史站点搬进新系统时，通常是先建模型再导数据：自定义内容模型里把产品参数、发布时间这类需要筛选的项定成自定义字段，正文富文本留在文档体里。模型没定就导表格，字段列会被丢弃或落进错位置，后面补一次就要重跑一遍。

字段对不上时查这三处

第一步看表头。表格第一行的列名要和模型里的字段名逐列对应，中英文、空格与大小写都会造成匹配失败；建议先删掉空列，只留确实要写入的列。

第二步看空值与占位。历史导出常把「暂无」「-」写成占位文本，这些值会被当有效数据入库，前台显示就变成一堆占位符。导入前统一改成空单元格，让模板层的缺省逻辑接管。

第三步看重复。同一份表格跑两次会产生重复文档，AnQiCMS 的文档内容导入接口（路径里的 import 与 archive 两个动作）支持按标题查询是否已存在，重跑前先用它比一轮，比事后手工删要省时间。标题查重比看图判断可靠，因为图片缺失往往只是标题不对的连带表现。

图片找不到时再查压缩包侧

表格侧确认无误后，再按这个顺序看压缩包：图片是否放在解压后可以定位的目录；文件名是否与表格中引用的名字完全一致，扩展名大小写也要一致；同名文件是否存在于多个层级，导致引用指向不确定。

一次常见的错法是表格里的文件名带着旧站点的目录前缀，解压后是干净的短文件名，引用全部落空。这类问题的判断方法很直接：随机抽几行，把表格里的引用名和压缩包里的实际文件名做字面对照，一致率低于预期就先改名，别急着改系统配置。

导入之后怎么抽查

导入结果不要靠「看着没报错」来确认。按四类各抽几篇：带图片的、带自定义字段的、分类与标签被写入的、以及标题重复的。抽出来的文档状态要明确——落草稿还是正式文档，AnQiCMS 的文档状态分为正式文档、草稿、待发布和回收站，批量导入建议先落草稿，用 preview 预览链接核对渲染效果，再批量转正式。

上线前留一次备份点。批量写入是可回退性的典型场景，备份覆盖数据与静态文件，一旦整批字段错位，可以退回重跑而不必逐篇手工修。

常见问题

上千篇一次导还是分批导？ 分批更稳，按分类切批次，每批导完抽查一次；单批出问题只影响该批，回退范围小。

字段和图片同时不对，先修哪个？ 先修字段。字段错会让引用关系整体错位，看起来就像图片也丢了。

重跑会不会产生重复文档？ 会，所以先用按标题查询是否已存在的导入接口判断，再决定跳过还是覆盖。