批量导入时正文里的图片怎么带上，附件上传有几种方式

批量导入文章时正文引用的图片怎么处理、附件上传有哪几种方式，取决于走哪条导入路径：压缩包路径可以把资源目录和正文一起打包进去，表格路径只承载文本，接口路径则要靠附件上传单独提交。AnQiCMS 支持 ZIP 压缩包和 Excel 表格两种批量导入方式，两条路对图片的处理完全不同，先把这一点定下来再准备文件，比导入之后再返工省事得多。

导入时图片有哪三种来源

第一种是资源文件跟着正文一起进来，适合整站搬迁或大批量建库；第二种是表格只写文字，图片后续单独上传或按标题自动配图补上封面；第三种是接口调用时把小文件作为附件随请求提交。三种来源的差别不在「能不能带图」，而在图片落在媒体库的哪一步、正文里的地址什么时候可用。

最容易踩的坑是：表格里写了图片地址，指向的还是旧站的外链或本地临时目录，导入后正文显示正常，一旦源站清理就整片裂图。

压缩包路径怎么带资源

ZIP 路径的核心是把目录结构固定下来：正文文件、图片资源目录、以及一份说明导入顺序的清单。做法上有三条经验：

• 资源文件名在打包前就确定，别依赖导出工具生成的随机串，否则正文里的相对地址和文件名对不上；
• 正文用相对路径引用资源，让导入程序按自己的目录规则重新落位，而不是硬写绝对地址；
• 一次导入的体量按批次拆，不要一个包里塞几百张图，导入失败时整批回滚比重跑更费时。

走这条路径时，标题自动配图可以作为补充：缺封面的文章按标题内容分配图片，避免批量导入后首页列表出现空白缩略。

表格路径适合什么场景

Excel 表格只承载文本字段，标题、栏目、标签、发布时间这类结构化信息适合它，图片则不适合。它的强项是同一批内容反复改：先在表格里把字段核对干净，再一次性导入；正文里需要图片时，要么走压缩包补资源，要么导入后交给自动配图。

如果这批内容本身来自其他站点，就属于内容采集的范围，和批量导入是两条链路，别指望一张表格同时解决取内容和放图片。

接口上传附件为什么用 base64

自 v3.6.5 起，接口侧支持把附件按 base64 提交，好处是单个请求内完成，不需要先申请一个临时上传地址再回头关联。代价也明确：请求体被编码放大，只适合小文件。

导入之后先核对哪三处

第一处是媒体库引用：抽几篇文章看图片是不是已经落在站内地址上，而不是原站地址。第二处是列表页缩略图：封面缺失的文章在这里最容易暴露。第三处是失败清单：批量导入通常会给未完成记录，先补完再开下一批，不要积累。

常见问题

问：表格能不能直接写图片的网址，让系统去抓？ 答：能写，但那是远程抓取链路，不在表格导入的保证范围内。真要批量带图，压缩包更可靠；表格里的地址应当已经指向站内媒体库。

问：一次导入多少篇比较合适？ 答：按你拆批的粒度定，把「一批一次能核对完」作为上限。带资源目录的压缩包批次要比纯文本批次更小，因为失败回滚的成本更高。

问：导入后图片显示正常，过几天裂了，什么原因？ 答：绝大多数是正文地址指向外部源站或临时目录。核对方法是抽几篇看图片域名是不是自己站点的。

问：同名文章会被覆盖吗？ 答：批量导入前先按标题查重，把重复项在表格里处理干净；接口方式走的是站内导入通道（archive 与 import 这条路径），同样提供按标题查询是否已存在的能力。