Shopify CSV 重复选项修复指南

不要凭空编造新的选项值

如果 CSV 用于更新现有商品，修改 Option 值可能生成新的变体 ID，并影响依赖这些 ID 的应用。编辑前先在商店确认该变体的真实含义。

这个错误是什么意思

Shopify 提示同一商品可能有重复选项，也可能是同一 Handle 的商品在 CSV 别处重复出现。需要对照完整选项组合，不能只看某一个尺码或颜色单元格。真正的变体行共用 Handle 是正常的。

下方两行都属于 tee，且都对应 Size: M 选项组合。窄屏下可横向滚动代码块查看全部列。

错误：选项组合重复

Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,M

V001 会报告这两条业务记录。续行中的 Title 和 Option1 name 留空，不会让第二个 M 变成不同变体。

示意修正：两个不同尺码

Title,URL handle,Option1 name,Option1 value
Tee,tee,Size,M
,tee,,L

只有第二行确实是 L 码时才写 L；否则应核对来源数据，删除确认重复的记录，或修正商品对应关系。

01
保留原始 CSV。按 URL handle 将记录分组，再比较每个商品内 Option1 value、Option2 value 和 Option3 value 的所有非空值。
02
确认重复行是不同的真实变体、误复制的商品行，还是仅用于图片的续行。不能只凭重复 Handle 就重命名商品。
03
修正真正的来源错误：填写真实选项值、只删除确认重复的记录，或在确属其他商品时使用正确 Handle。
04
重新本地检查，复核其他问题；如果涉及已有变体，导入前还要在 Shopify 核实可能的 ID 变化。

Catalog Precheck 的 V001 规则报告同一 Handle 下重复的非空 Option1–3 组合，并忽略纯图片续行。工具无法决定哪一行正确，也看不到商店已有变体。返回工具时会打开新的校验页，不会保留之前选择的文件。

V001 检查同一份文件是否重复使用选项组合。两份文件的组合都可以唯一，但修改仍可能改变已有变体的识别方式。

Shopify 提示，修改 Option1/2/3 value 会更换已有变体 ID，可能影响依赖这些 ID 的应用。保持 SKU 相同并不能保留变体 ID。

此例包含一个 Hoodie 商品、四个明确变体。仅两格 Option1 value 从 Blue 改为 Navy；SKU、Logo、Price 45、handle woo-45 和其余单元格均不变。两份文件都通过当前 Validator 检查。

两格 Color 修改；Logo 和 SKU 保持相同
SKU	A · Color	B · Color	Logo
`woo-hoodie-blue`	Blue	Navy	No
`woo-hoodie-blue-logo`	Blue	Navy	Yes

基于 WooCommerce 官方样例转换的 Shopify 草稿 CSV，再做受控修改。官方原样例不含此修改前后对照。文件用于练习，并非你的商店导出。固定版本的官方样例

01
在下方载入公开演示，保留“我不确定”，运行 Compare，查看两种覆盖场景。
02
选择覆盖时，应看到两条高风险“疑似 Option 变化”提示，另外两个变体精确匹配。不覆盖时，已有 handle 会被忽略，此例没有差异提示。
03
展开两条提示，复核 Blue → Navy 与 No / Yes 的 Logo 值，再下载对比报告。实际更新请用商店最新导出与修改后文件对比，并在商店核实受影响的变体及应用引用。

Compare 使用 handle 和完整选项组合识别变体，唯一的 SKU 或条码可提供疑似修改线索。它不能读取实际商店的变体 ID，也不预测导入结果；这两份公开文件不含商店 ID。

仅获取两份公开样例。对比在浏览器内执行，不上传文件内容；此次练习无需账号或测试商店。

官方 CSV 说明核对日期：2026 年 10 月 7 日： Shopify：商品 CSV 选项与变体 ID

仍然无法确定的部分

文件层面的检查通过，不代表 CSV 与 Shopify 已有变体一致或导入一定成功。改变现有商品选项前，应核实目标商品和变体 ID。

Catalog Precheck 是独立工具，与 Shopify 无隶属关系。