YAML/CSV轉換

YAML 記錄如何變成 CSV 欄列

YAML 可用縮排表示映射與序列；CSV 則把每筆記錄排成欄位。這項轉換適合處理欄位相近、可以逐筆排列的資料，例如一串人員、商品或測試案例。YAML 轉 CSV 時，頂層清單中的每筆映射會成為一筆表格資料，鍵名用來辨認欄位；CSV 轉回 YAML 時，第一列會作為欄名，後續列成為序列中的記錄。

例如，兩筆都具有 name 與 score 的資料，可以整理成 name,score 欄名列，再各用一列放姓名與分數。若只是單一設定物件、欄位層層嵌套或每筆結構差異很大，表格就不容易完整呈現原本的資料關係。

欄名、值與格式規範

CSV 的首列欄名決定回轉 YAML 時各值所屬的鍵，因此欄名應清楚且每欄一致。RFC 4180 描述常見 CSV 中以逗號分欄、以引號包住含逗號或換行的欄位等慣例；實際讀取時仍須配合接收程式的格式設定。YAML 規範則定義映射、序列、純量以及註解、錨點和別名等結構。這些表示方式不全都有 CSV 欄列的對應項目。

先整理成一致的記錄，再轉換

1. 選擇輸入方向

   預設可從 YAML 轉成 CSV；需要反向處理時切換兩側格式，並確認輸入框旁標示的來源格式。

2. 準備欄位相近的資料

   YAML 建議使用多筆欄位一致的映射清單。CSV 請把欄名放在第一列，每筆資料另占一列；先修正空白或重複欄名。

3. 貼上內容並查看結果

   貼上文字後會自動轉換。看到解析錯誤時，檢查 YAML 的縮排、冒號和引號，或 CSV 的欄位分隔與引號是否配對。

4. 抽查後複製或下載

   比對欄名、記錄數、空值與代表性欄位，再複製結果或下載轉換後的文字檔。匯入其他系統前，確認該系統採用相同欄名和分隔方式。

轉換前後最常需要確認的地方

表格化可能改變資料語義

此工具沒有欄名或分隔符設定項，也不提供任意巢狀欄位展平控制；CSV 輸出使用逗號分隔及欄名列。YAML 註解、錨點、別名、複雜鍵和深層結構不能假設可在 CSV 中完整保存。CSV 也沒有內建的欄位型別標記，讀取時的型別推斷可能改變原本看似文字的值。正式設定或重要資料請保留來源副本，並在匯入前核對欄名、列數、空值、前導零、特殊字元及接收端的解析結果。