旧站文章批量搬过来,用压缩包导入还是表格导入更稳
旧站文章要批量搬过来,用 ZIP 压缩包导入还是用 Excel 表格导入更稳,答案取决于两件事:迁移要不要带附件,以及内容有没有稳定的字段结构。带图文与静态文件的整站搬迁走压缩包更稳;正文以结构化字段为主、需要批量映射成文章的走表格更省事。两种入口都是 AnQiCMS 批量导入能力支持的形态。
迁移前先决定带不带附件
先做一条判断:旧站文章的图片、附件、下载文件是否要一起搬。要搬,就得保留文件名与相对路径关系,这正是 ZIP 压缩包的强项;不搬,只搬文字与元数据,表格更直观,也便于人工校对。这一步决定了后面所有动作,不要两种混着用,否则同一批文章会出现两种落库路径,出错时很难定位。
两种入口的适用边界
| 迁移场景 | 建议入口 | 原因 | 注意点 | | 图文混排、带本地附件 | ZIP 压缩包 | 文件与正文一起落库 | 目录层级不要过深 | | 字段规整的批量建稿 | Excel 表格 | 列与内容模型字段直接映射 | 日期与空值写法要统一 | | 反复增量导入 | import/archive 接口 | 可按标题查询是否已存在 | 先查后写,避免重复 | | 结构差异大的老数据 | 先表格后补附件 | 分两步便于核对 | 第二步按标题对齐 |
表格导入前把列映射定下来
表格导入的稳定性主要来自内容模型:先确认目标模型的字段清单,再决定表格列。常见的四列是标题、正文、分类、标签,若有自定义字段(例如型号、地区、时长),要把列名与字段一一对应,不要在正文里塞临时标记。导出旧数据时顺手做三件清理:去掉富文本里指向旧站域名的绝对地址,统一时间格式,删掉空正文的记录。这三件事不做,导入后会出现大量需要逐条修改的脏数据。
压缩包导入的顺序怎么排
压缩包导入建议按批次组织:一批对应一个栏目或一个季度的内容,包内文件命名保留旧站的原始标识(例如文章 id 或 slug),便于导入后核对数量。单包不要贪大,出现个别文件失败时只回滚一小批。导入完成后先抽样看三类页面:带图正文、带附件的下载页、有自定义字段的模型页,这三类最容易在格式转换时出问题。
重复导入前用接口做校验
跨批次搬迁最容易发生的是重灌。AnQiCMS 提供文档内容导入接口 /api/import/archive,并支持按标题查询文档是否已存在,把「先查后写」做成固定流程:每次导入前用标题查询一遍,命中已存在的记录先人工判断是覆盖还是跳过。对需要长期同步的旧站,这个入口比反复手工导表更稳。
迁移出错后的兜底与检查项
删除正式文档不会物理删除,内容会移入回收站,可以恢复,因此导错批次时先撤下再核对,不必担心永久丢失。收尾检查看四项:文章总数是否与旧站清单一致;抽样页面的图片是否能显示;分类与标签是否落到目标栏目;旧地址到新地址的重定向映射是否已配置。确认无误后再处理收录相关动作,避免迁移期同时改动两层。
常见问题
旧站导出格式不规范怎么办
先做一次性清洗脚本,把格式统一成表格列与附件目录两种产物,再分别走表格导入与压缩包导入,不要指望导入端容错。
一次能搬多少篇
按栏目分批更稳,单批控制在可人工抽样的规模内,出问题能定位到批次而不是整站。
搬完之后排名会不会掉
迁移期主要风险在地址变化与页面缺失。保持新地址结构稳定、把旧地址的重定向逐条映射到位,再对照旧站高流量页做抽样验证,波动通常可控。