导出修改后无法将CSV产品列表导入Shopify的技术求助

核心排查点及解决方法 #

• 必填列缺失或列名不匹配：Shopify导入CSV必须包含Handle、Title、Vendor三个核心必填列，且列名需与Shopify导出的CSV完全一致（比如Body (HTML)不能简写为Description）。建议导出手动创建的示例产品CSV，对比你的导入文件列名，确保完全对齐。
• Handle异常：
  • 若CSV中Handle为空，Shopify无法识别唯一标识，会直接跳过该行；
  • 若Handle与已删除产品的Handle重复（Shopify删除产品后Handle会保留一段时间），或与示例产品的Handle重复，导入时会被判定为更新现有产品而非新增，导致看不到新条目。
• 字段格式错误：如果Body (HTML)、Tags等字段包含逗号、换行或双引号，未用双引号包裹会导致CSV解析错位。例如正确格式应为"This product has a comma, in description"，未包裹的逗号会被当成列分隔符，导致后续字段无法被Shopify识别。
• 产品状态设置：若CSV中Published列值为FALSE，产品会导入但处于未发布状态，需在后台切换到「未发布产品」标签查看。
• 导入模式选择错误：导入时若选择「更新现有产品」，而CSV中的Handle在后台不存在（包括已删除的），Shopify不会新增产品。应选择「添加新产品」模式测试。
• 编码或格式问题：确保CSV为UTF-8无BOM编码（部分编辑器保存的UTF-8带BOM会导致解析错误），且确实是逗号分隔（可打开文本编辑器确认分隔符）。
• 单条数据错误：若某一行存在格式问题，可能导致整批导入被静默跳过。建议先导入前3-5行测试，定位是否存在坏行。

快速验证步骤 #

1. 导出示例产品的CSV，复制几行并修改Handle、Title为新值，保存后重新导入，验证是否能成功新增产品。
2. 用纯文本编辑器（如VS Code）打开你的导入CSV，检查每一行必填字段是否非空，特殊字段是否正确包裹双引号。
3. 导入后查看后台「未发布产品」「草稿产品」列表，确认是否有导入的产品。

内容的提问来源于stack exchange，提问作者aaao