CSV error dictionary
商品 CSV 匯入錯誤訊息對照表:先看哪個欄位最可能壞掉
平台常只丟一句「欄位格式錯誤」或「部分資料匯入失敗」,但真正的問題可能在表頭、商品名稱、SKU、價格、圖片網址或換行。這份對照表先幫你把錯誤訊息翻成可檢查的欄位。
先不要整份重做:
把失敗列切成 3 到 5 列小檔,再按下面的「優先檢查」欄位逐項排查。若懷疑有看不見的空白或特殊字元,先用 平台字元安全檢查器。
想先看完整包長什麼樣:
下載 CSV 上架救援智能體包免費 sample。Sample 只放前 5 條錯誤、壞 CSV 前後對照與一段 AI 追問示範;完整包會把「錯誤訊息 -> 欄位定位 -> 清理公式 -> 5 列驗收」整理成可重複交付的流程。
錯誤訊息對照表
| 錯誤訊息或症狀 | 優先檢查 | 可能原因 | 下一步 |
|---|---|---|---|
| 欄位格式錯誤 | 表頭、價格、庫存 | 表頭多空白、價格含幣別、庫存不是整數。 | 切 5 列小檔,先清表頭與數字欄。 |
| 找不到必要欄位 | 第一列表頭 | 欄名被改、全形空白、範本版本不一致。 | 下載平台最新範本,不手打欄名。 |
| 商品名稱格式錯誤 | 商品名稱 | Emoji、換行、智慧引號、零寬字元。 | 先做字元檢查,再看標題長度。 |
| SKU 重複 | SKU | 同款規格沒有尾碼,或前後空白造成假重複。 | 清空白後排序查重。 |
| SKU 更新不到商品 | SKU 與平台匯出檔 | 全形英數、大小寫不一致、平台原 SKU 被改。 | 以平台匯出的現有商品檔為準。 |
| 價格格式錯誤 | 價格欄 | 含 NT$、逗號、元、促銷文案或小數格式不合。 | 只留平台允許的數字格式。 |
| CSV 亂碼 | 檔案編碼 | 不是 UTF-8、另存格式不合、BOM 問題。 | 另存 UTF-8 CSV,先匯入小檔。 |
| 欄位數量不一致 | 逗號、換行、描述欄 | 欄位內有逗號或換行,CSV 引用不正確。 | 先清換行,描述欄另行檢查。 |
| 圖片網址無效 | 圖片欄 | 私有雲端連結、過期連結、網址含空白。 | 改用公開可讀圖片網址。 |
| 成功列數少於總列數 | 失敗列報告 | 只有部分列混入特殊欄位或資料格式不合。 | 抽失敗列做小檔,逐欄排查。 |
最短排查順序
- 備份原始 CSV。
- 只留下表頭與 3 到 5 列失敗資料,另存小檔。
- 先查表頭,不要先改商品內容。
- 再查商品名稱、SKU、價格、圖片網址。
- 小檔成功後,再套用到完整檔。
什麼時候該用智能體包?
如果你每次匯入都會遇到不同錯誤,問題通常不是單一公式,而是缺一套固定排查流程。CSV 上架救援智能體包 把匯入救援、商品標題清理、SKU/價格欄檢查與活動毛利檢查拆成可重複使用的提示詞與樣本資料。
- 同一份 CSV 每修一欄又冒出另一個錯誤。
- 你需要把錯誤交給 AI 協助,但不想貼客戶訂單或整份商品資料。
- 你想把排查步驟交給同事、工讀或未來的自己重複執行。
下一步:
先下載 免費 sample ZIP 看壞資料前後對照;再看 完整智能體包介紹。如果錯誤集中在 SKU,看 蝦皮商品 CSV 顯示 SKU 重複怎麼修?;如果是價格欄報錯,看 商品 CSV 價格格式錯誤怎麼辦?;如果只是單純空白或換行,看 Excel 全形空白怎麼移除?。
廣告預留區:穩定 hosting 與內容量足夠後再啟用。