指南
H001

Shopify CSV “無效的 CSV 標頭:缺少標頭”:要檢查的內容

檢查 CSV 的第一行,以了解您匯入所需的確切產品列名稱。缺少 Title 標頭是一個常見原因,但所需的列取決於您是建立產品、更新產品還是添加變體。

規則定義

缺少必需的 Title 欄。

嚴重

自動修正範圍: 此規則需要手動複核;工具不會自動修改業務資料。

規則定義

更新或新增變體所需的 URL Handle 缺失。

嚴重警告

自動修正範圍: 此規則需要手動複核;工具不會自動修改業務資料。

不要貼上舊範本中的每一列
Shopify 的錯誤頁顯示較舊的完整標題行。其目前產品 CSV 格式指南根據匯入場景提供了不同的最小列數。從您的實際文件和預期操作開始。

該訊息指向什麼

第一行定義列。拼字錯誤的標題、多餘的空格、錯誤的分隔符號或從其他 CSV 類型複製的標題可能會阻止 Shopify 識別欄位。在更改產品資料之前檢查實際標題行。

需要哪些標頭?

創造一個簡單的產品:

Title 是唯一需要的色譜管柱。可以從標題產生不存在的 URL 句柄。

更新現有產品:

包含 Title 和 URL 句柄,以便 Shopify 可以識別產品。

新增變體:

包括 URL 句柄。更新與型號相關的列(例如 SKU)時,也要保留匹配的 Option1 名稱和 Option1 值列;省略從屬選項資料可以更改變體。

缺少 Title 標頭

這個最小更新範例具有產品名稱,但其第一個標題不是 Shopify 的 Title 欄位。

無效:Product 標題不是 Title
Product title,URL handle
Tee,tee

目錄預檢查報告 H001 缺少 Title 標頭,並警告 Product 標題未知。

更正:使用支援的標題
Title,URL handle
Tee,tee

僅當其值確實是產品標題時才重新命名該列。保留原始文件的副本。

如何安全地修復標頭

  1. 01

    确认这是 Shopify 产品 CSV,而不是库存或其他应用程序的导出。以 UTF-8 逗号分隔文本形式打开副本。

  2. 02

    检查第一行,包括拼写和尾随空格。將每個標題與其下方的資料相匹配;不要僅僅為了消除錯誤而重新命名不相關的值。

  3. 03

    在決定需要哪些欄位之前選擇建立或更新。對於更新和變體,請保留句柄和任何依賴選項列。

  4. 04

    儲存新的 CSV,在本機檢查它,然後在匯入之前檢查 Shopify 的目前樣本和匯入設定。

本地檢查標頭

在目錄預檢查中選擇所需的導入模式。 H001 標記遺失的 Title; H002 檢查何時需要 URL 句柄; H003 會警告無法辨識的標題。這些是檔案檢查,而不是模擬 Shopify 匯入。返回開啟一個新的驗證器;先前選擇的檔案不會被保留。
檢查員無法決定什麼
它無法知道未知標題是否屬於有效的應用程式整合、重新命名的欄位是否包含正確的業務資料或商店中已存在的內容。乾淨的報告並不能保證導入成功。

来源检查:2026 年 9 月 28 日。 Shopify:常見導入問題 · Shopify:目前產品 CSV 格式

Catalog Precheck 是一个独立的工具,不隶属于 Shopify。