这个提示指向哪里
CSV 第一行定义列名。拼错表头、末尾多余空格、分隔符错误，或误用其他类型 CSV 的表头，都可能使 Shopify 无法识别字段。修改商品数据前先检查真实表头行。
哪些表头是必需的？
只要求 Title 列；没有 URL handle 时可按标题生成。
需要 Title 和 URL handle，以便识别目标商品。
需要 URL handle。更新 SKU 等变体相关列时，还要保留对应的 Option1 name 与 Option1 value；遗漏依赖的选项数据可能改变变体。
缺少 Title 表头的示例
这个最小更新示例包含商品名称，但第一列表头不是 Shopify 的 Title。
Product title,URL handle
Tee,tee
Catalog Precheck 会以 H001 报告缺少 Title，并提示 Product title 是未知表头。
Title,URL handle
Tee,tee
只有在该列的值确实是商品标题时才重命名，并保留原文件副本。
如何安全修复表头
- 01
确认这是 Shopify 商品 CSV，而不是库存 CSV 或其他应用的导出。以 UTF-8 逗号分隔文本打开副本。
- 02
检查第一行的拼写和末尾空格，并对照每列下方的实际数据；不要为了消除提示而重命名无关内容。
- 03
先确定是新增还是更新，再判断必填列。更新商品或变体时，保留 Handle 和依赖的选项列。
- 04
另存为新 CSV，在本地检查后，再对照 Shopify 当前模板与导入设置进行导入。
空值与省略列：更新时有什么区别？
覆盖更新匹配商品时，非必填列保留但值为空，可能清空已有值；整列不包含在文件中，则保留该可选列的已有值。不勾选覆盖时，匹配的 handle 会被忽略。以下演示两种 Vendor 修改。
公开原文件含两个商品、四个变体：数字商品的 Vendor 为 Harmony Publishing，香水为 Acme。一份修改文件保留 57 列，仅清空这两个非空 Vendor 单元格；另一份只移除 Vendor 整列，剩下 56 列。价格、handle、选项及其他保留单元格均不变；三份文件都通过当前 update 模式 Validator 检查。
| URL handle | 原始 Vendor | 保留该列 | 省略该列 |
|---|---|---|---|
digital-product-the-history-of-rock-music | Harmony Publishing | （单元格为空） | （没有 Vendor 列） |
example-perfume | Acme | （单元格为空） | （没有 Vendor 列） |
原文件复用 2026 年 9 月 28 日获取的 Shopify 官方 CSV，四个变体的公开子集未修改单元格。两份修改文件是用于练习的受控衍生示例，并非你的商店导出。 官方 CSV 下载（当前版本）
- 01
选择下方一种修改示例，载入同页 Compare，保留“不确定”并运行对比。两种情况都应精确匹配两个商品、四个变体。
- 02
覆盖开启时，Vendor 置空会产生两条高风险“非空值变为空值”提示。省略 Vendor 的示例没有发现项，因为没有比较该列。不覆盖时，两种情况都不对匹配的 handle 产生发现项。
- 03
下载完整报告，再切换另一种示例并重新载入。切换会清除此前文件与结果。实际更新请比较目标商店最新导出与修改文件，复核全部保留字段，再做少量试导入。
仅获取两份公开样例。对比在浏览器内执行，不上传文件内容；此次练习无需账号或测试商店。
没有发现项不代表导入安全。Compare 只检查两份文件中的部分字段，不读取商店。其他保留列及其空值仍可能覆盖商店数据；此可选 Vendor 演示不涵盖必填字段、库存 CSV、关联选项或新商品默认值。
官方导入说明核对日期：2026 年 10 月 7 日： 覆盖规则与字段依赖
来源核对日期：2026 年 9 月 28 日。 Shopify：常见导入问题 · Shopify：当前商品 CSV 格式
Catalog Precheck 是独立工具，与 Shopify 无隶属关系。