CSV column mismatch
CSV 欄位錯位
逗號、換行、引號怎麼查?
商品 CSV 最可怕的錯誤之一,是匯入後每一欄都往旁邊跑:價格跑到庫存、圖片網址被切成兩欄、商品描述把下一列吃掉。這通常不是平台壞掉,而是某個欄位裡多了逗號、換行或沒有成對的雙引號。
先做小檔測試:
不要直接改完整檔。先複製表頭、失敗列、前後各一列,做成 3 到 5 列小檔,才看得出是哪一欄把整列推歪。
欄位錯位的常見樣子
如果平台只說「欄位數量不一致」或「第 24 列格式錯誤」,你可以先看這幾種症狀:
- 價格出現在庫存欄,庫存出現在商品描述欄。
- 圖片網址從
https://...被切成兩欄。 - 商品描述裡有換行,匯入後變成下一筆商品。
- Excel 看起來正常,但另存 CSV 後平台吃不進去。
- 只有某幾列失敗,其他列可以正常匯入。
第一個要查:欄位內逗號
CSV 用逗號分隔欄位。如果商品名稱、規格、描述或圖片欄位裡也有逗號,卻沒有被正確包在雙引號裡,平台就會把一個欄位拆成兩欄。
最小修法是先把高風險欄位中的半形逗號換成全形逗號,或確認匯出工具會自動用雙引號包住內容。商品描述、規格說明、注意事項最常出這個問題。
第二個要查:欄位內換行
商品描述常從舊賣場、LINE 訊息、Notion 或 Google 文件複製,裡面可能有換行。某些平台允許描述換行,但很多批次匯入範本不喜歡欄位內換行。
如果你看到「下一列資料少一欄」或「某列被切成兩筆商品」,先把描述欄換行改成空格或分號,再做小檔匯入。
第三個要查:雙引號沒有成對
CSV 裡的雙引號很敏感。若欄位開頭有一個 ",但結尾沒有對應的 ",後面的逗號與換行都可能被當成同一欄內容,整份資料就會亂掉。
常見來源是商品標題裡寫了尺寸,例如 12" 收納盒。你可以先把雙引號改成「吋」,或在匯出前確認系統會正確跳脫。
第四個要查:表頭數量和資料列數量
如果平台說欄位數量不一致,先用最笨但有效的方法:數第一列表頭有幾欄,再數失敗列切出來有幾欄。兩邊數量不同,表示資料列中有某個欄位被逗號、換行或引號切開。
- 保留原始檔,另存一份檢查用副本。
- 只留下表頭、失敗列、前後各一列。
- 先刪商品描述欄測一次;若成功,問題多半在描述。
- 再檢查商品名稱、規格、圖片網址、選項欄。
- 修完後用 5 列小檔匯入,成功再套回完整檔。
Excel 裡看起來正常,不代表 CSV 正常
Excel 會幫你把很多問題顯示得很漂亮,但平台讀的是純文字 CSV。只要純文字裡的逗號、換行、雙引號沒有處理好,Excel 預覽再整齊也可能匯入失敗。
如果你不確定,可以先用記事本或文字編輯器打開小檔,看失敗列附近是不是突然多了換行,或某一列的逗號數量明顯比其他列多。
下一步:
如果你懷疑是不可見字元或全形空白,先用 平台字元安全檢查器 掃商品名稱、SKU 和表頭。如果你想把排查流程交給 AI 重複使用,查看 小店上架救援智能體交付包。
廣告預留區:內容量、穩定網址與廣告平台審核完成後啟用。