CSV emergency SOP
CSV 上架錯誤急救 SOP：30 分鐘內先定位哪一欄壞掉
商品 CSV 上傳失敗時，最浪費時間的做法是整份重做、整批重傳、一直改同一欄。先用 30 分鐘把錯誤縮小到 5 列小檔，再判斷是表頭、SKU、價格、圖片網址、換行，還是不可見字元造成的。
先保留現場：
下載平台回傳的錯誤檔、截圖錯誤訊息，複製原始 CSV 一份。不要直接在唯一檔案上改，否則後面會分不清楚是原錯誤還是新錯誤。
第 0 到 5 分鐘：先切一份 5 列測試檔
完整 CSV 有幾十到幾百筆時，平台只回一句「匯入失敗」很常見。先保留表頭，再挑 5 筆資料：
- 2 筆你認為格式最正常的商品。
- 1 筆含多規格、SKU 或選項的商品。
- 1 筆有圖片網址或長描述的商品。
- 1 筆平台回報錯誤的商品。
只測 5 列的好處是：如果小檔成功，代表問題在其他列；如果小檔也失敗，代表表頭、欄位格式或共通欄位更可疑。
第 5 到 12 分鐘：看錯誤訊息，不要猜
| 錯誤訊息類型 | 優先檢查 | 下一步 |
|---|---|---|
| 欄位格式錯誤 | 表頭名稱、欄位順序、必填欄位、日期或數字格式。 | 拿官方範本比對，不要自己新增或刪掉欄位。 |
| SKU 重複 | 前後空白、全形空白、大小寫、不可見字元。 | 先清 SKU 欄，再用小檔確認。 |
| 價格格式錯誤 | NT$、逗號、小數點、全形數字、空白。 | 價格欄只留平台接受的數字格式。 |
| 圖片網址無效 | 公開權限、https、網址前後空白、換行、雲端分享頁。 | 用無痕視窗打開圖片網址確認可讀。 |
| 資料列錯位 | 描述欄換行、逗號、雙引號、多圖分隔符。 | 先修含長描述或多圖的列。 |
第 12 到 20 分鐘：用固定順序清欄位
不要每次看到錯誤就改不同地方。建議用這個順序：
- 表頭：欄位名稱、欄位數量、順序是否跟官方範本一致。
- SKU：去掉前後空白、全形空白、不可見字元。
- 價格：只保留數字，不放 NT$、逗號或說明字。
- 商品名稱：檢查換行、Emoji、零寬字元與過長字數。
- 圖片網址：用無痕視窗開 URL，確認不用登入也能看圖。
- 描述欄：把段落換行先減少，排除欄位錯位。
第 20 到 30 分鐘：再丟一次 5 列小檔
清完欄位後，不要直接丟完整檔。先重新匯出 5 列小檔測一次。若成功，再把同樣清理方式套到完整檔；若失敗，代表還有共通欄位或平台範本版本不一致。
常用 Excel / Google Sheets 公式
清商品名稱、SKU、圖片網址前後空白：
=TRIM(CLEAN(SUBSTITUTE(A2," "," ")))把價格欄常見符號移除：
=SUBSTITUTE(SUBSTITUTE(SUBSTITUTE(A2,"NT$",""),",","")," ","")檢查清理後字串長度是否變短：
=LEN(A2)&" → "&LEN(TRIM(CLEAN(SUBSTITUTE(A2," "," "))))什麼時候該停止手改？
如果你已經修過表頭、SKU、價格、圖片網址，但每次平台都換不同錯誤，通常代表檔案裡有多種小問題混在一起。這時候不要靠記憶亂改，改用固定檢查表，把每一欄的「原值、清理後、測試結果」留下來。