WooCommerce 商品數量一旦超過 100 件，靠手工逐一新增就變得事倍功半。這時批量匯入就成了必要技能——透過官方內建的 CSV 匯入工具，短時間內把成百上千件商品一口氣入庫，避免重複手動輸入的冗長流程。本篇詳解 CSV 欄位格式、常見坑點排查，讓大批量上架變得高效確實。
CSV 檔案格式與欄位對應
WooCommerce 批量匯入商品的第一步是準備符合規格的 CSV 檔。官方的匯入工具雖然功能受限，但只要欄位對應正確，就能順暢把商品資料寫入資料庫。
CSV 檔的首列必須是欄位標題列，往下才是商品資料列。常見欄位包括商品 ID（ID）、名稱（Name）、類別（Categories）、標籤（Tags）、價格（Price）、成本價（Cost）、庫存（Stock Qty）、描述（Description）、圖片網址（Image）等。其中「Name」與「Price」是基礎必填，其他欄位按需求補充即可。編碼務必選 UTF-8，避免中文字呈現亂碼。
一個完整的 CSV 示例欄位列序可能長這樣：ID、Name、Categories、Price、Cost、Stock Qty、Description、Image、Weight、Length、Width、Height。使用試算表軟體（Excel、Google Sheets）編輯好後，另存新檔為 CSV 格式。如果從現有系統匯出，先用 UTF-8 編碼確認，再上傳到 WooCommerce。
圖片網址的正確填法
商品圖片是消費者決策的關鍵視覺要素。CSV 裡怎麼帶圖片網址常常踩坑，因為 WooCommerce 的匯入工具在圖片欄位只接受完整的圖片 URL，不能上傳本機檔案。
圖片網址必須是一個可直接在瀏覽器開啟、返回圖片檔案的有效 URL，比如 https://example.com/images/product-123.jpg。WooCommerce 會在匯入時逐一下載這些圖片，儲存到 WordPress 媒體庫。網址若格式錯誤或無法連線，匯入會失敗或該商品的圖片欄留空。確保圖片所在的伺服器允許外部連線，沒有防盜鏈限制；如果原始圖片在另一個網域，先檢查防火牆與 CORS 設定。
另外，一張圖片網址只能映射到一項商品。若同一張圖要用在多個商品，每列都填寫相同的 URL，匯入時會各自下載一份。若要設定多個商品圖，CSV 官方工具只支援特色圖（首張），其他產品圖得匯入後在 WooCommerce 後台逐一補上。
規格商品與父子關係設定
簡單商品只需要 SKU、價格、庫存就能成立，但規格商品（如 T 恤有尺寸 S、M、L 三種變化）就複雜一些。CSV 匯入時，規格商品的父商品與子變化商品要用對應的欄位正確設定，否則匯入後規格選項不會出現。
在 CSV 裡，父商品與子商品分開兩列。父商品那列在「Type」欄填 variable，同時留空 SKU、Price 等子商品專有的欄位。子商品那列在「Type」欄填 variation，然後在「Parent」欄指定父商品的 ID（或名稱），在「Attributes」欄寫上規格鍵值對，比如 size=L 或 color=red;size=M。父商品層級設定商品名稱、描述、特色圖；每個變化商品層級設定 SKU、價格、庫存、變化圖片。
舉例來說，若要建立一款「藍色 T 恤」分三個尺寸販售，CSV 應該是這樣的結構：第一列是父商品，Type 填 variable，Name 填「藍色 T 恤」，Price 留空；接下來三列分別是 S、M、L 尺寸的變化商品，Type 填 variation，Parent 填「藍色 T 恤」（或父商品 ID），Price 各自填對應價格，Attributes 填 size=S、size=M、size=L。匯入完成後，前台選品頁就會顯示尺寸下拉選單，訪客可依需求選購。
常見匯入錯誤與排查方法
CSV 檔往往看似無誤，匯入時仍可能卡關。理解常見錯誤類型有助快速定位問題。
類別名稱不匹配是常見坑。WooCommerce 會比對 CSV 的類別欄與現有分類庫，若類別根本不存在，匯入會略過或報錯。解法是先在 WooCommerce 後台手動建立要用的類別，確保名稱與 CSV 裡的拼法一致，再重新匯入。
貨幣符號與價格格式也要注意。CSV 的價格欄只接受純數字（如 999.99），不要帶 $ 或 元 符號，否則匯入時可能無法辨識為有效數字。
編碼問題導致中文亂碼是另一大困擾。Excel 在 Windows 上預設用 Big5 或 ANSI 編碼，匯出 CSV 時容易變成非 UTF-8。解法是在 Excel 裡用「另存新檔」時明確選「CSV UTF-8」格式，或在試算表軟體（Google Sheets）直接下載為 CSV，Google 預設輸出 UTF-8。如果檔案已經亂碼，用文字編輯器（Notepad++、VS Code）開檔，選擇轉換編碼為 UTF-8 再存檔。
圖片網址無法連線導致匯入中止，則需先確認網址是否真的能在瀏覽器打開、是否有防盜鏈限制、服務商是否允許外部存取。簡易測試方式是從 CSV 裡隨便抽一個 URL，貼到瀏覽器網址列，看能不能成功載入圖片。若不行，向圖片供應商或原伺服器管理員確認存取權限。
庫存欄為負數或非數字也會卡關。WooCommerce 預設庫存只接受零或正整數。若 CSV 裡出現 -5 或 abc，匯入會失敗或留空。匯入前用試算表的驗證或篩選功能檢查庫存欄，確保全為有效數值。
分批與增量匯入策略
一次匯入數千件商品時，伺服器可能因執行時間過長或記憶體超額而中斷，導致匯入不完整。為規避此風險，改採分批策略——把大檔案切成數個小批次（如每批 500 件），逐次匯入。這樣即使某一批失敗，其他批次也不受影響，問題也更容易定位。
增量匯入是指後續添加或修改既有商品。如果 CSV 裡的商品 ID 與 WooCommerce 資料庫中的某筆商品 ID 相同，匯入時會自動更新該商品資訊，而不是新建。這對於定期更新價格、庫存、描述的情況相當便利——只需準備異動商品的 CSV，包含 ID 與異動欄位即可，其他未列的欄位保持不變。
第一次大批量匯入時建議先在測試環境（本地或備用站點）跑一遍，確認格式無誤、圖片都能載入、規格商品的父子關係正確，再在正式環境正式匯入。這樣可以避免在線上環境發現問題時已經部分入庫、難以回滾的局面。
匯入後的驗證檢查
CSV 匯入完成不代表任務結束，仍要逐一驗證資料完整性與展示效果。進入 WooCommerce 後台的商品列表，檢查新增商品數是否符合預期；若少於 CSV 的列數，代表部分商品匯入失敗，需要查看失敗日誌。
逐一點進幾個代表商品，檢查商品名稱、價格、庫存數無誤；描述內容是否被完整匯入（有時特殊字符或換行會被截斷）；圖片是否正常顯示且在媒體庫中能找到。規格商品則要確認選項下拉選單運作正常、各變化的價格與庫存獨立。
前台頁面也要實地走一遍搜尋與選購流程，看商品能否正確篩選、排序、加入購物車。批量匯入難免會有零星漏洞——這一步驗證有助及時發現與補救，避免上線後客人吐槽資料不準。