CSV 匯入失敗怎麼辦？先檢查商品標題、全形空白和不可見字元

CSV 匯入失敗很煩，因為錯誤訊息常常只說「格式錯誤」或「某列失敗」。但很多時候問題不是整份檔案都壞掉，而是某幾個欄位混進看不見的字元、換行、價格符號或表頭空白。

第一步：不要直接重做整份檔案

遇到匯入失敗，最容易浪費時間的做法是整份重新整理。比較穩的做法是先做一份測試檔，只保留表頭與 3 到 5 列資料。小檔若能成功，代表完整檔裡可能只有某幾列或某幾欄出問題；小檔也失敗，才回頭看表頭、編碼與欄位格式。

第二步：先看表頭有沒有藏空白

平台範本通常會要求固定欄位名稱，例如 SKU、商品名稱、價格、庫存。表頭前後多一個空白、全形空白，甚至從文件複製來的不可見字元，都可能讓平台認不出欄位。

• 把第一列表頭複製到字元檢查器。
• 確認沒有全形空白、零寬字元或換行。
• 不要手動猜欄位名稱，優先使用平台下載的範本。

第三步：商品標題最容易出事

商品標題常從 LINE、Excel、Google 文件、Notion、ChatGPT 或舊商品頁複製。看起來只是普通文字，但可能包含 Emoji、智慧引號、全形標點、零寬字元或換行。社群貼文可以接受的符號，不一定適合 CSV 匯入。

如果你看到「某列商品名稱格式錯誤」「標題不可使用特殊字元」「匯入後標題斷行」，先檢查標題欄，不要先改價格或分類。

第四步：價格欄只留平台接受的數字

價格欄常見錯誤是把顯示格式也放進資料，例如 NT$1,280、1,280 元、免費 或含空白的數字。有些平台可以自動處理，有些會直接失敗。匯入前最好只留下平台接受的數字格式。

第五步：SKU 要注意全形英數與重複值

SKU 看起來像英文數字，但如果是全形 ＡＢＣ１２３，在系統裡就不是 ABC123。這會造成庫存對不上、更新不到原商品，或平台判定為另一個商品。匯入前也要檢查 SKU 是否重複。

第六步：欄位內換行會讓 CSV 錯位

商品描述可以有換行，但商品標題、SKU、分類、價格通常不應該有。若欄位內換行沒有被正確引用，CSV 可能被切成兩列，後面的欄位全部錯位。

最小測試方法：把失敗列前後各一列留下，另存小檔匯入。如果小檔仍錯，通常比看完整檔容易定位。

建議的 10 分鐘排查順序

1. 備份原始 CSV，不要直接覆蓋。
2. 切出只含表頭與 3 到 5 列的測試檔。
3. 掃表頭：空白、全形空白、不可見字元。
4. 掃商品標題：Emoji、換行、智慧引號、零寬字元。
5. 掃 SKU：全形英數、前後空白、重複值。
6. 掃價格：只保留數字或平台接受格式。
7. 用小檔匯入測試。
8. 成功後再套用到完整檔。