先说结论
“重复”可能指两种不同情况。
同一个 SKU 可能在 CSV 中出现两次,也可能与 WooCommerce 店铺中的现有商品相同。只看文件能发现第一种情况;要确认第二种,需要店铺导出和导入日志。勾选“更新现有商品”后,WooCommerce 会用 ID 或 SKU 匹配现有商品。
保存导入日志,先备份店铺,并保留一份未修改的商品导出。不要为了消除报错随意更换生产环境的 SKU:订单、库存同步和其他集成可能依赖它。
如果文件在处理商品行之前就被拒绝,请先查看 WooCommerce CSV 综合故障清单(英文)。
四种情况
根据失败行选择处理方式。
店铺中已有相同 SKU
CSV 行的 SKU 相同,不代表新建导入会自动变成更新操作。
下一步: 如果本来要修改该商品,先导出当前商品行,再检查“更新现有商品”选项;如果确实是新商品,应使用独有的 SKU。
文件中两行使用同一 SKU
商品或变体需要明确且唯一的标识;文件内重复 SKU 需要人工判断。
下一步: 确认两行描述的是同一商品、不同商品,还是不同变体。保留正确的商品标识,不要机械地给每个重复值加数字。
更新模式跳过未匹配的行
WooCommerce 更新现有商品时按 ID 或 SKU 匹配;普通商品行未匹配时通常会被跳过。
下一步: 将该行与此店铺最新的导出结果对照。修正要匹配的 ID 或 SKU;真正的新商品应另行用新建模式导入。
变体被跳过或关联到错误的父商品
变体需要自身的标识,Parent 字段也必须指向预期的可变商品。
下一步: 检查父商品 SKU 或 id:123 引用、每个变体的 SKU 和属性值。更新模式下新变体行的处理取决于 WooCommerce 版本及该行满足的条件。
工具能力边界
本地检查无法看到你的店铺数据。
- CSV 文件内部重复的 SKU
- 缺失标识和常见的行结构问题
- 店铺已有的 ID 和 SKU
- 导入模式、列映射及被跳过行的日志
- 当前安装版本创建变体的具体规则
免费扫描只在你的浏览器中运行,不连接 WooCommerce,也不会代你决定已有 SKU 应更新哪件商品。
安全复测
先用小批量确认模式和商品标识。
- 01保留原件
备份店铺,保存日志和最新商品导出。
- 02分类
区分文件内部重复与店铺中已有的 SKU。
- 03选择模式
确认新建或更新,并复核列映射。
- 04小量测试
条件允许时,在测试站导入一两条代表性记录。
- 05核验结果
检查商品、变体、价格、库存和导入日志,再扩大范围。
官方资料(英文)