Shopify CSV 提示“Invalid CSV header: missing headers”怎么办
先检查 CSV 第一行是否使用本次导入所需的准确商品表头。缺少 Title 是常见原因，但新建商品、更新商品和新增变体的必填列并不完全相同。
不要照抄旧模板的整行表头
Shopify 的报错页列出一整行旧版表头；当前商品 CSV 格式说明则按导入场景规定最低必填列。应先确认自己的文件和导入意图。
这个提示指向哪里
CSV 第一行定义列名。拼错表头、末尾多余空格、分隔符错误，或误用其他类型 CSV 的表头，都可能使 Shopify 无法识别字段。修改商品数据前先检查真实表头行。
哪些表头是必需的？
新建普通商品： 只要求 Title 列；没有 URL handle 时可按标题生成。
更新现有商品： 需要 Title 和 URL handle，以便识别目标商品。
新增变体： 需要 URL handle。更新 SKU 等变体相关列时，还要保留对应的 Option1 name 与 Option1 value；遗漏依赖的选项数据可能改变变体。
缺少 Title 表头的示例
这个最小更新示例包含商品名称，但第一列表头不是 Shopify 的 Title。
错误：Product title 不等于 Title
Product title,URL handle
Tee,tee
Catalog Precheck 会以 H001 报告缺少 Title，并提示 Product title 是未知表头。
修正：使用受支持的表头
Title,URL handle
Tee,tee
只有在该列的值确实是商品标题时才重命名，并保留原文件副本。
如何安全修复表头
- 确认这是 Shopify 商品 CSV，而不是库存 CSV 或其他应用的导出。以 UTF-8 逗号分隔文本打开副本。
- 检查第一行的拼写和末尾空格，并对照每列下方的实际数据；不要为了消除提示而重命名无关内容。
- 先确定是新增还是更新，再判断必填列。更新商品或变体时，保留 Handle 和依赖的选项列。
- 另存为新 CSV，在本地检查后，再对照 Shopify 当前模板与导入设置进行导入。
在本地检查表头
在 Catalog Precheck 中选择导入意图。H001 提示缺少 Title；H002 按场景检查 URL handle；H003 提醒未识别的表头。这些是文件检查，不是 Shopify 导入模拟。
工具无法替你判断的部分
工具无法知道未知表头是否属于有效应用字段、重命名后的列是否装着正确业务数据，也无法查看商店已有商品。报告无问题不保证导入成功。
来源核对日期：2026 年 9 月 28 日。 Shopify：常见导入问题 · Shopify：当前商品 CSV 格式
Catalog Precheck 是独立工具，与 Shopify 无隶属关系。