Shopify 批量上传商品 CSV：模板与校验指南

安全的 Shopify 商品 CSV 流程：

1. 导出当前目录备份，并下载 Shopify 当前样本商品 CSV。
2. 保留官方表头名称，删除示例商品，保留商品到变体的行结构。
3. 校验 handle、选项值、价格、库存字段、分类、metafield 和公开图片 URL。
4. 保存为 UTF-8 CSV，先导入一个有代表性的小样本。
5. 检查导入后的商品和变体，再依赖新目录数据。

Shopify 批量上传商品时，应基于当前样本构建 CSV，再填入自己的目录数据。这样能保留 Shopify 期望的商品与变体行关系。先看 官方 CSV 格式指南和可下载样本，因为表头和市场列可能因店铺而异。

用当前店铺数据构建商品 CSV

做更新时，先导出计划修改的商品，并保留一份未改动副本。导出文件会显示店铺真实的 handle、变体选项、市场列和 metafield。做新目录时，下载 Shopify 样本；加入自己的行前先删除示例商品，否则示例商品可能被误导入。

Shopify 文档说明：新商品需要 title；更新商品需要 handle 和 title；新增变体需要 handle 和变体数据。其他字段即使不是普遍必填，也可能有依赖关系。不要因为小测试能导入就删列：删掉相关选项字段，可能改变已有变体。

按商品和变体组织 CSV 行

简单商品可以在第一行放商品详情。追加图片时，后续行可以用同一 handle 和图片 URL。有变体的商品，第一行放商品级信息，变体行使用同一 handle 和对应选项/变体值。图片行和变体行要严格遵循当前样本结构。

导出前检查：

• 每个商品分组有有效、明确的 handle，没有尾随空格。
• 变体选项名称和值存在，且在同一商品内唯一。
• 变体价格、SKU、条码、重量和库存字段在正确行上。
• title 和条件必填字段已填写。
• 商品分类使用 Shopify 支持的 taxonomy 值。
• Metafield 表头使用预期 namespace 和 key；引用商品存在。
• 不要用商品 CSV 做其他 Shopify 流程该做的事。例如，Shopify 说明商品样本库存数量适用于单地点店铺；多地点库存应使用单独的 库存 CSV 格式。

检查覆盖与变体后果

导入时，Shopify 对匹配 handle 提供覆盖选项。可选列“存在但为空”可能清空已有值，而文件中完全省略该列可能保留原值；依赖另一个缺失字段的列也可能导致数据被删或导入报错。先决定这次是全量商品更新还是窄字段更新，并在检查依赖后只保留必要列。

修改变体选项列的值可能创建新的变体 ID，影响保存了变体 ID 的集成。如果只是改标题或描述，不要改变选项值。如果确实要重构变体，先规划并验证下游影响。

校验图片、编码与字段值

文件要保存为 UTF-8 CSV，使用预期分隔符。Shopify 指南建议 UTF-8 和 LF 换行；表格软件可能使用不同导出设置。把导出文件当文本重新打开，确认第一行是表头，含逗号或引号的值没有被破坏。

图片 URL 应是公开可访问的直接图片链接。用未登录后台的会话测试不同主机和样本 URL，删除已删媒体的旧链接。CSV 不能上传图片文件本身，只能引用托管图片 URL。

按类型检查值：价格和数量字段应是预期格式的数字；布尔类字段使用接受值；库存政策受支持；选项名称在变体间一致；市场定价列对应导出模板中的市场名称。不要在应填纯值的单元格里加货币符号或表格公式。

两轮导入与复核

较大改动要按逻辑分批，先导入小而有代表性的文件。样本应包含简单商品、多变体、多图、可选字段和最高风险 metafield。导入后检查商品页、变体选项、价格、图片、指定地点库存和相关自动流程。保留原始备份。

Shopify 的 商品导入说明提醒：导入开始后无法取消，并建议先备份。平台还在 常见导入问题指南中列出表头、handle、引号、库存字段、分类、图片和商品引用的具体错误。根据报错修正数据，再重复小测试，之后才扩大。

导入确认后，可以把已核对成本和价格映射到 Bulk SKU Profit Auditor检查 SKU 贡献。它使用另一套经济性 CSV，不验证 Shopify 商品导入。

常见问题

在哪里下载 Shopify 商品 CSV 模板？

用 Shopify 当前“Using CSV files to import and export products”指南里的可下载样本。使用前删除示例商品行，并核对当前字段名和条件。

Shopify 商品 CSV 哪些字段必填？

取决于新建还是更新、是否包含变体或依赖字段。Shopify 目前说明新商品需要 title，更新需要 handle 和 title；条件字段以当前格式表为准。

表格软件会把 CSV 存成错误格式吗？

会。导出设置可能改变编码、分隔符、引号和换行。保存为 UTF-8 CSV 后重新打开，确认表头和含逗号的值没有被破坏。

DTCStack 的 SKU 审计器会验证 Shopify 上传吗？

不会。它分析另一种 CSV 布局，用于 SKU 贡献和获客假设。Shopify 导入校验必须遵循其当前商品 CSV 格式和店铺实际报错。