台灣小工具研究室
CSV column mismatch

CSV 欄位錯位
逗號、換行、引號怎麼查?

商品 CSV 最可怕的錯誤之一,是匯入後每一欄都往旁邊跑:價格跑到庫存、圖片網址被切成兩欄、商品描述把下一列吃掉。這通常不是平台壞掉,而是某個欄位裡多了逗號、換行或沒有成對的雙引號。

先做小檔測試: 不要直接改完整檔。先複製表頭、失敗列、前後各一列,做成 3 到 5 列小檔,才看得出是哪一欄把整列推歪。

欄位錯位的常見樣子

如果平台只說「欄位數量不一致」或「第 24 列格式錯誤」,你可以先看這幾種症狀:

第一個要查:欄位內逗號

CSV 用逗號分隔欄位。如果商品名稱、規格、描述或圖片欄位裡也有逗號,卻沒有被正確包在雙引號裡,平台就會把一個欄位拆成兩欄。

最小修法是先把高風險欄位中的半形逗號換成全形逗號,或確認匯出工具會自動用雙引號包住內容。商品描述、規格說明、注意事項最常出這個問題。

第二個要查:欄位內換行

商品描述常從舊賣場、LINE 訊息、Notion 或 Google 文件複製,裡面可能有換行。某些平台允許描述換行,但很多批次匯入範本不喜歡欄位內換行。

如果你看到「下一列資料少一欄」或「某列被切成兩筆商品」,先把描述欄換行改成空格或分號,再做小檔匯入。

第三個要查:雙引號沒有成對

CSV 裡的雙引號很敏感。若欄位開頭有一個 ",但結尾沒有對應的 ",後面的逗號與換行都可能被當成同一欄內容,整份資料就會亂掉。

常見來源是商品標題裡寫了尺寸,例如 12" 收納盒。你可以先把雙引號改成「吋」,或在匯出前確認系統會正確跳脫。

第四個要查:表頭數量和資料列數量

如果平台說欄位數量不一致,先用最笨但有效的方法:數第一列表頭有幾欄,再數失敗列切出來有幾欄。兩邊數量不同,表示資料列中有某個欄位被逗號、換行或引號切開。

  1. 保留原始檔,另存一份檢查用副本。
  2. 只留下表頭、失敗列、前後各一列。
  3. 先刪商品描述欄測一次;若成功,問題多半在描述。
  4. 再檢查商品名稱、規格、圖片網址、選項欄。
  5. 修完後用 5 列小檔匯入,成功再套回完整檔。

Excel 裡看起來正常,不代表 CSV 正常

Excel 會幫你把很多問題顯示得很漂亮,但平台讀的是純文字 CSV。只要純文字裡的逗號、換行、雙引號沒有處理好,Excel 預覽再整齊也可能匯入失敗。

如果你不確定,可以先用記事本或文字編輯器打開小檔,看失敗列附近是不是突然多了換行,或某一列的逗號數量明顯比其他列多。

下一步: 如果你懷疑是不可見字元或全形空白,先用 平台字元安全檢查器 掃商品名稱、SKU 和表頭。如果你想把排查流程交給 AI 重複使用,查看 小店上架救援智能體交付包
相關排查: 也可以接著看 CSV 錯誤訊息對照表價格格式錯誤圖片網址無效
廣告預留區:內容量、穩定網址與廣告平台審核完成後啟用。