实务专题 · 交付验收

商品CSV里留空,不一定代表保留原值

导入人员可能把空单元格理解为“不更新”,平台却可能理解为清除旧值。批量导入前,应区分空白、缺列与明确替换。CSV语法正确,不代表不会破坏已有商品信息。

适用读者与交付决定

委托商品目录导入的零售商。把本题作为网站供应方的有限验收任务;实际系统证据不能由教学例子替代。

官方依据与解释边界

Shopify说明:包含但留空的非必填列可能清空旧值;不包含该列则保留旧值,关联字段还有额外规则。 Shopify: product CSV · 核对日期:2026年10月16日。

已填写教学例子

合成例子,不是真实客户案例。 列出有限输入、预期结果及反例,不代表已完成真实平台集成。

窄屏可横向滚动表格。

输入/情况检查口径预期结果
old Vendor=Maker A; column omitted缺少更新键保留
Vendor included as blank明确空值清除
Vendor=Maker B替换Maker B

怎样执行验收

  1. 导出可恢复副本,确认测试子集的精确标识。
  2. 每列标记保留、清除或替换,并检查关联列。
  3. 只导入获准测试子集,再导出比较变更前后字段。

如何解释结果与保留证据

教学函数利用属性是否存在模拟一个可选Vendor字段,不解析CSV;空字符串明确算变更。真实导入还要检查标识、变体关系及平台默认值。前后差异表应列出意外清空,不能因为没有解析错误就称导入成功。

适用边界

不执行生产导入或旧内容变更;不覆盖CSV公式安全、地点库存导入,也不推广为所有列通则。

离线复核

把下方两份文件存入同一目录,以Node22.13或更新版本运行。示例不联网、不修改任何账号或网站。 已填输入与预期输出 · 可检查的函数

node decision-check.mjs product-csv-blank-versus-omitted.json