研台灣小工具研究室
CSV description check

商品描述有換行導致 CSV 欄位錯位怎麼辦？先查逗號、雙引號與換行

商品描述通常是 CSV 裡最容易破壞格式的欄位。描述一長，就可能混進換行、逗號、雙引號、HTML 片段或從 Word 複製來的特殊符號。平台匯入後看到的症狀，常常不是「描述錯」，而是價格跑到庫存欄、圖片網址被切開、下一筆商品被吃掉。

先不要整批重做： 先抽 5 筆商品，把描述欄縮短、去掉換行，再跟原檔對照。若縮短後能上傳，問題通常就在描述欄的分隔符、換行或引號。

描述欄出問題時常見症狀

你看到的狀況 可能原因 先查哪裡
價格跑到庫存欄 描述裡的逗號被當成欄位分隔。 描述欄是否有英文逗號、半形逗號或未正確包住的文字。
下一列商品被吃掉 描述欄有換行，但平台沒有把它視為同一格內容。 描述欄是否有 Enter、Shift+Enter、HTML 換行標籤或複製來的段落。
圖片網址被切成兩段 描述或圖片欄混入逗號、空白或多個網址分隔符。 圖片欄是否只放平台要求的分隔格式，描述欄是否多了一個欄位。
平台顯示欄位數不符 某列比表頭多一格或少一格。 用 5 筆小檔逐列比對欄位數，從描述最長的商品開始查。
匯入成功但前台描述亂掉 HTML、特殊引號或全形符號被平台轉換。 先用純文字描述測試，再逐步加回換行與項目符號。

先做一個 5 筆商品小檔

不要直接改完整商品檔。先複製 5 筆最容易出錯的商品，保留原本表頭，做三個版本比對。

版本 描述欄處理方式 判斷結果
A 原始版 保留原本描述。 如果失敗，保留錯誤訊息與失敗列號。
B 短描述版 每筆描述只留 20 個字，不放逗號與換行。 如果成功，代表描述欄是主要風險。
C 清理版 保留商品賣點，但移除換行、未成對雙引號與多餘逗號。 如果成功，再把規則套回完整檔。

描述欄清理順序

  1. 把描述先轉成純文字，移除從 Word、Canva 或網頁複製來的隱藏格式。
  2. 把段落換行改成平台接受的格式，例如空格、句號或平台指定的 HTML 標籤。
  3. 檢查雙引號是否成對；若不確定，先改成單引號或全形引號。
  4. 把英文逗號改成頓號、分號或換成短句，避免被 CSV 當成分隔欄位。
  5. 把商品規格、注意事項、保固、出貨說明拆成固定段落，不要每筆商品自由發揮。

Excel 或 Google Sheets 可先這樣查

如果你先在試算表裡整理商品資料，可以新增幾個輔助欄位，先找出高風險描述。

要查的風險 可用做法 看到結果後
換行 搜尋儲存格內換行，或用替換功能把換行改成空格。 先不要刪整段，保留語意後再縮短。
逗號 找出描述中含半形逗號的商品。 改成中文標點，或確認匯出時有正確處理引號。
雙引號 找出包含 " 的商品描述。 確認是否成對；不確定就先改成其他標點。
描述過長 用字數或長度公式找出最長的 20 筆。 先測這些商品，通常最容易讓欄位錯位。

不要把所有資料塞進描述欄

有些賣家會把尺寸、材質、注意事項、出貨規則、保固、付款提醒全部放進描述欄。這樣看似方便，但批次匯入時會讓描述變成最不穩定的欄位。比較好的做法是把可以結構化的資料拆出去。

30 分鐘排查流程

  1. 複製原檔，保留一份不修改。
  2. 挑 5 筆描述最長、最容易失敗的商品做小檔。
  3. 先把描述縮短成一行純文字，再上傳測試。
  4. 若成功，逐步加回必要賣點，不一次加回整段描述。
  5. 確認描述欄穩定後，再檢查 SKU、價格、庫存與圖片欄。
下一步： 把 5 筆小檔或其中幾列描述貼到 商品資料免費健檢器，先查換行、欄位、SKU、價格與圖片風險。若你想拿到修正 sample、欄位對照與驗收清單，可以看 商品資料健檢報告樣本，或填寫 商品資料健檢需求單。

本文是商品資料整理與匯入排查建議。不同平台對 CSV、Excel、HTML 描述與換行的處理方式不同，實際欄位仍以平台最新範本與後台提示為準。

廣告預留區：內容量與審核條件足夠後再啟用。