JSON vs XML vs YAML vs CSV:到底該用哪一種?
JSON、XML、YAML、CSV 是每位開發者、資料分析師和技術寫作者在 2026 年都會遇到的四種結構化資料格式。每一種都為不同的問題而生,沒有一種被淘汰,真正的問題不是「哪個最好」而是「哪個符合你手頭的工作流程」。本指南為你提供 30 秒決策框架、橫向對比表、每種格式的深度解析與真實程式碼範例、六組可複製貼上的相互轉換命令,以及一張涵蓋 2026 年所有常見場景的格式選擇表。

1. JSON vs XML vs YAML vs CSV:2026 年到底用哪一個?
在 JSON vs XML vs YAML vs CSV 的對比中沒有單一贏家。這四種格式誕生於不同的十年,各自解決不同的問題,2026 年仍在生產環境中使用,正是因為沒有一種格式能替代另外三種完成的工作。本節的任務是讓你用 30 秒拿到答案,再據此跳到實際需要的轉換命令或場景推薦表。
最短的版本:走網路傳輸資料或存到文件資料庫,選 JSON;交換需要 schema、命名空間或混合內容的文件,選 XML;如果由人手編輯設定檔,選 YAML;如果由人在試算表裡開啟檔案,選 CSV。本指南剩下的內容,就是這四句話的長版本,以及支撐它們的證據。
1.1 30 秒決策框架
讀下面與你正在做的工作相符的四行:
• 「我在架一個 API 或行動 App」→ JSON。它是 Web 界的共通語,每種語言都自帶解析器,每個 HTTP 用戶端原生支援。
• 「我在交換需要 XSD schema 的業務文件、法律文書或任何需要 schema 的內容」→ XML。它是四種格式中唯一原生支援命名空間、混合內容和機器可讀 schema 驗證的。
• 「我在寫一個需要人手編輯的設定檔」→ YAML。以縮排為基礎的語法讀起來像大綱,支援註解,是 Kubernetes、GitHub Actions、Docker Compose、Ansible 的預設。
• 「我在從試算表匯入或匯出資料」→ CSV。它是四種格式中 Excel、Google Sheets、Apple Numbers 以及地球上每個 BI 工具都能免轉換開啟的。
1.2 四種格式的簡史
XML 由 W3C 在 1998 年發布,是早期 Web 的結構化文件格式。它曾是 SOAP、RSS、XHTML 和 Office Open XML 近十年間的共通語。CSV 比 XML 早約 25 年——自 1979 年最初的 VisiCalc 誕生起,CSV 就是試算表的母語,也是這四種格式中唯一不是「被設計出來」而是「從人類在文字檔裡輸入一行資料的方式中自然湧現出來」的格式。JSON 由 Douglas Crockford 在 2001 年推廣開來,作為 XML 在 AJAX 請求中的 JavaScript 友好替代品,並在 2008 年 iPhone 讓 REST API 成為預設之後接管了 Web。YAML 在 2001 年發布,名為 "YAML Ain't Markup Language"——一種人類友好的設定語法,借鑑了 Python 的縮排思路和 Perl 的井號註解風格。
這四種格式與其說是互相替代,不如說是把世界分成了四個重疊的領域:文件(XML)、Web API(JSON)、設定(YAML)、表格資料(CSV)。2026 年這四個領域仍然是這四個領域,這四種格式也仍然是這四種格式。
1.3 為什麼四種格式在 2026 年仍然共存
三個結構性原因讓四種格式都留在生產環境中:
• 每一種都是不同工作的最低成本工具。JSON 是最低成本的網路資料傳輸格式,因為解析器非常小。XML 是最低成本的文件格式,因為它有命名空間、schema 和混合內容。YAML 是最低成本的設定格式,因為人能讀能改且不會出錯。CSV 是最低成本的表格資料格式,因為地球上的每個試算表都能免轉換開啟。
• 解析器都已成熟且通用。每種現代語言都為這四種格式內建了標準庫解析器。Python、JavaScript、Java、C#、Go、Rust 都不需要安裝套件就能讀取它們。
• 切換成本為零,但生態成本很高。把一個 JSON 檔轉成 YAML 只是一行命令。把整個 AWS 生態從 JSON 遷到 XML 卻是十年遷移專案。四種格式之所以持續存在,是因為它們周圍的生態持續存在。
1.4 2026 年誰在用哪種格式
• JSON —— 每個 REST API、每個行動 App、每個 Web 前端、每個 NoSQL 資料庫(MongoDB、Couchbase、Elasticsearch)、每個不需要註解的現代設定檔,以及每個 AI / LLM 內容視窗。
• XML —— 每個 SOAP 與企業整合(SAP、Oracle、Microsoft BizTalk)、每個 Office Open XML 文件(.docx、.xlsx、.pptx 都是 XML 的 ZIP)、每個醫療標準(HL7、FHIR、DICOM 中繼資料)、每個政府資料交換(IRS、SEC、USPTO)、每個 RSS / Atom 訂閱源,以及每個 SVG 影像。
• YAML —— 每個 Kubernetes 清單、每個 Docker Compose 檔、每個 GitHub Actions workflow、每個 Ansible playbook、每個 CircleCI / GitLab CI 流水線、每個 Cloudflare Workers 的 wrangler.toml,以及大多數現代靜態網站設定檔(Astro、Hugo、Jekyll)。
• CSV —— 每個銀行對帳單、每個 Excel 匯出、每個 Google Sheets 下載、每個 Stripe 撥款、每個 Shopify 商品 feed、每個 Google Analytics 匯出、每個 pandas / R / Stata / SPSS 資料集,以及世界上每個機器學習訓練集。
2026 年,「JSON vs XML」是錯誤的問題——正確的問題是「我的流水線其他環節已經說哪種語言?」。選擇能直接融入你現有工具、團隊熟悉度以及下游消費者的格式,而不需要做轉換。轉換永遠只是一行命令的事;生態錯配會讓你付出幾個月的代價。
2. 橫向對比表
下表是 2026 年四種格式的權威參考。選用的維度是真正能改變決策的:可讀性、結構、工具鏈和最佳適用場景。不會改變決策的維度(發明年份、原始作者)已在 1.2 節集中列出,這裡刻意省略。
| 屬性 | JSON | XML | YAML | CSV |
|---|---|---|---|---|
| 標準 | RFC 8259 / ECMA-404 | W3C XML 1.0 / 1.1 | YAML 1.2(ISO/IEC 19503:2024) | RFC 4180(事實標準) |
| 發布年份 | 2001 年(RFC 8259 於 2017 年) | 1998 年 | 2001 年(1.2 於 2009 年) | 1972 年(RFC 4180 於 2005 年) |
| 語法 | 大括號和方括號 | 帶閉合標籤的尖括號 | 縮排和冒號 | 每行以逗號分隔的值 |
| 人眼可讀性 | 資料場景極佳,文件場景一般 | 冗長但明確 | 最佳(讀起來像大綱) | 表格最佳,階層場景差 |
| 副檔名 | .json | .xml | .yaml 或 .yml | .csv |
| MIME 類型 | application/json | application/xml 或 text/xml | application/yaml(非官方:text/yaml) | text/csv |
| 支援巢狀結構 | 是(物件與陣列) | 是(無限層級,帶命名空間) | 是(對映與序列) | 否(僅扁平列) |
| 支援註解 | 否(變通:`_comment` 鍵) | 是(`<!-- -->`) | 是(`#`) | 否(變通:獨立欄) |
| 支援 schema 驗證 | 是(JSON Schema 2020-12) | 是(XSD 1.1、RelaxNG、Schematron) | 否(YAML 無官方 schema) | 否 |
| 支援二進位資料 | 僅 Base64 編碼字串 | Base64 或十六進位 | 僅 Base64 編碼字串 | 否(僅文字) |
| 允許尾隨逗號 | 否 | 否(但空白容錯) | 否 | 否(會導致 Excel 匯入錯誤) |
| 同等資料檔案大小 | 最小 | 最大(3-5 倍 JSON) | 2-3 倍 JSON(縮排) | 扁平表最小 |
| 解析速度(典型) | 最快 | 最慢(XML 解析最重) | 中等(縮排解析增加額外負荷) | 最快(逐行) |
| 預設場景 | Web API、NoSQL、AI 內容 | 文件、SOAP、schema、RSS | 設定檔、CI 流水線、K8s | 試算表、資料集、匯出 |
| Excel / Sheets 原生 | 否(需匯入) | 否(需匯入) | 否(需匯入) | 是(雙擊開啟) |
| 最佳場景 | 機器對機器資料交換 | 帶 schema 的文件交換 | 人手編輯的設定檔 | 表格資料與匯出 |
3. JSON:Web 界的通用資料格式
JSON(JavaScript Object Notation)是每個 Web API、每個行動 App、每個 NoSQL 資料庫、每個現代 AI 內容視窗都已經會說的一種結構化資料格式。它是機器對機器通訊的預設選擇,也是人在不需要 XML 或 YAML 儀式感的情況下讀寫結構化資料的最受歡迎選擇。
3.1 JSON 的優勢
JSON 有六個結構優勢,可以解釋它在 2026 年的統治地位:
• 極小的解析器。每種現代語言都在標準函式庫內建了 JSON 解析器。Python 的 `json` 模組、JavaScript 的 `JSON.parse`、Go 的 `encoding/json` 套件、Java 的 `jackson-databind`、Rust 的 `serde_json` crate、C# 的 `System.Text.Json` 都隨語言附帶,無需額外安裝。
• 緊湊的語法。對於典型的結構化資料,JSON 是四種格式中最緊湊的。同樣負載用 JSON 是 100 KB,用 XML 是 300-500 KB,用 YAML 是 200-300 KB。
• 瀏覽器原生。JavaScript 可以用一個函式呼叫(`JSON.parse`)解析 JSON,再用另一個(`JSON.stringify`)序列化。此清單上其他格式沒有這種特性。
• 不需要 schema。你可以直接交付合法的 JSON,無需先定義 schema。這是 JSON 對早期 API 最大的生產力優勢。
• 完美適配文件型資料庫。MongoDB、Couchbase、Elasticsearch、Cosmos DB、DynamoDB 都原生儲存 JSON。PostgreSQL 在 2014 年加入了一等公民的 JSON 與 JSONB 支援。
• 完美適配 AI / LLM 內容視窗。每個現代大型模型都基於 JSON 訓練,能在內容視窗中理解 JSON。XML、YAML、CSV 也能辨識;但 JSON 是四種格式中唯一在 LLM 訓練資料中「第一公民」的格式。
3.2 JSON 的劣勢
JSON 有四個結構劣勢:
• 不支援註解。官方 JSON 規範(RFC 8259)不允許註解。JSON5、JSONC、帶尾隨逗號的 JSON 作為擴充存在,但與嚴格解析器不相容。
• 沒有內建 schema 強制。JSON Schema 存在,但它不是格式的一部分。生產環境中的大多數 JSON 檔案都由手寫程式碼驗證,而不是 schema。
• 沒有命名空間。同一份文件裡兩個不同的 `id` 欄位需要手工消歧(例如 `user_id` 和 `order_id`),而不是用命名空間前綴。
• 不支援混合內容。JSON 無法表達那種「參見 <b>第 2 節</b> 了解詳情」的文字與標籤混合內容,除非把它拆成文字節點樹。
3.3 2026 年何時使用 JSON
在以下場景使用 JSON:每個 REST API、每個 GraphQL API、每個 WebSocket 訊息、每個行動 App 負載、每個 NoSQL 文件、每個事件流訊息(Kafka、Kinesis、Pub/Sub)、每個不需要註解的設定檔、每個 AI / LLM 提示詞與回應、到文件型資料庫的每次資料匯出、每個 JavaScript 前端狀態樹,以及每個 CI/CD 製品。當消費者是程式、生產者也是程式時,JSON 就是正確答案。
3.4 JSON 實戰程式碼
一個典型的 JSON 檔案長這樣。它是 REST API 傳回單一客戶訂單時回傳的負載:
4. XML:企業文件標準
XML(Extensible Markup Language)是 2026 年每個企業整合、每個 Office 文件、每個醫療標準、每個政府資料交換仍然依賴的結構化資料格式。它是四種格式中最重、最冗長的,但也是唯一同時支援命名空間、schema、混合內容,以及書籍、法律合約、SOAP 信封所需文件結構的格式。
4.1 XML 的優勢
XML 有五個結構優勢,可以解釋它 30 年來沒有被淘汰:
• 命名空間。兩個不同的 `id` 屬性可以消歧為 `<order:id>` 和 `<customer:id>`,因為 XML 支援 XML Namespaces 1.0 規範。JSON、YAML、CSV 都沒有等價機制。
• Schema。XML 有三種競爭的 schema 語言(XSD 1.1、RelaxNG、Schematron),W3C XML Schema 標準是全球部署最廣的 schema 語言。XSD 讓你可以指定 `price_usd` 元素是 0 到 999999 之間的小數、`email` 符合某個正規表示式、`items` 包含恰好 1 到 100 個 `item` 子元素。本清單上其他格式沒有可比的驗證體系。
• 混合內容。XML 可以原生表達「參見 <b>第 2 節</b> 了解詳情」,文字與標籤交錯。JSON 不能。YAML 不能。CSV 不能。這就是 XML 是書籍、法律合約、技術文件唯一可行格式的原因。
• XSLT、XPath、XQuery。XML 在 W3C 標準棧裡有三種內建的查詢與轉換語言。JSON 有 JSONPath(社群標準,不是 W3C 標準)。YAML 一無所有。CSV 一無所有。XML 的查詢與轉換生態比其他三種格式深一個數量級。
• 無處不在。每個現代文書處理、試算表和簡報 App 都把檔案存為 XML 的 ZIP(Office Open XML)。每個 SVG 影像都是 XML。每個 EPUB 電子書都是 XML 的 ZIP。每個 SOAP 信封都是 XML。每個 RSS 和 Atom 訂閱源都是 XML。這個格式之所以看不見,正是因為它被嵌得這麼深。
4.2 XML 的劣勢
XML 有四個結構劣勢:
• 冗長。同樣負載用 JSON 是 100 KB,用 XML 是 300-500 KB,主要因為每個開標籤都對應一個閉標籤。著名的玩笑:「XML 之所以冗長,不是因為設計得冗長,而是因為 W3C 委員會沒法就 `</element>` 的更短寫法達成共識。」
• 解析慢。XML 1.0 規範要求在你讀到任何值之前先建構完整的文件物件模型(DOM)。JSON 解析器可以串流處理,XML 解析器(DOM)不能,而串流替代方案(SAX)用起來顯著更難。對於高吞吐 API,XML 比 JSON 慢 3-10 倍。
• 工具鏈複雜。XML 有 XSD、XSLT、XPath、XQuery、XInclude、XLink、XML Signature、XML Encryption、SOAP。大部分開發者只需要 XSD 和 XPath,但整個表面積令人望而生畏,文件也已經是幾十年前的。
• 屬性值裡沒有註解。`<!-- -->` 註解語法沒問題,但不能在屬性值裡放註解,這是 JSON、YAML、CSV 都沒有的尖銳問題。
4.3 2026 年何時使用 XML
在以下場景使用 XML:每個 SOAP 或企業整合(SAP、Oracle、Microsoft BizTalk、MuleSoft)、每條 HL7 / FHIR / DICOM 醫療訊息、每個政府申報(IRS、SEC、USPTO、歐盟電子發票)、每個 Office 文件(.docx、.xlsx、.pptx 都是 XML 的 ZIP)、每個 SVG 影像、每個 EPUB 電子書、每個 RSS / Atom 訂閱源、每個需要嚴格 XSD schema 的文件、每個使用 XSLT 的轉換流水線,以及每個包含文字與標籤混合內容的文件(書籍、法律合約、技術手冊)。當消費者是文件而非資料記錄時,XML 是正確答案。
4.4 XML 實戰程式碼
一個典型的 XML 檔案長這樣。它是 SOAP 端點傳回單張發票時的負載,帶命名空間和 schema 引用:
5. YAML:人類友善的設定格式
YAML(YAML Ain't Markup Language,最初是 "Yet Another Markup Language")是每個現代設定檔、每個容器編排工具、每個 CI/CD 流水線在 2026 年都在用的結構化資料格式。它是四種格式中從第一天起就為人類讀寫而設計的,這也是它成為 Kubernetes、Docker Compose、GitHub Actions、Ansible、Cloudflare Wrangler 預設格式的原因。
5.1 YAML 的優勢
YAML 有四個結構優勢:
• 一流的人類可讀性。YAML 讀起來像大綱,用縮排表示結構。同樣資料在 JSON 中要 20 行,在 YAML 中往往只要 10 行,而且 YAML 版本可以一眼讀懂,不需要數括號。
• 一流的註解。YAML 在檔案任何位置都支援 `#` 註解,大多數編輯器能正確高亮。JSON 不支援註解。CSV 不支援註解。XML 支援註解,但 `<!-- -->` 語法很笨拙。
• 一流的多行字串。YAML 支援折疊(`>`)和字面(`|`)塊標量,這是把多行字串、SQL 查詢或私鑰嵌入設定檔中最乾淨的方式。JSON 需要 ` ` 跳脫;XML 需要 CDATA;CSV 根本做不了。
• 一流的引用。YAML 支援錨點(`&`)和別名(`*`),你可以定義一次然後在多處引用。JSON 沒有等價物。XML 有實體但很笨拙。CSV 沒有等價物。
5.2 YAML 的劣勢
YAML 有四個結構劣勢:
• 對空白敏感。一個放錯的空格或定位字元就會破壞文件。YAML 完全禁止在縮排中使用定位字元,這會讓從網頁或 IDE 自動縮排功能複製貼上時踩坑。
• 同一資料有多種寫法。YAML 有流式(`{a: 1, b: 2}`)和塊式(`a: 1 b: 2`)。它有兩種多行字串。它有兩種布林(`true` 和 `yes`)。對人類友好,但對解析器是噩夢。
• 安全風險:`unsafe_load`。Python 的 `yaml.load()` 函式如果不帶 `Loader` 參數,會執行任意 Python 程式碼。過去十年裡所有主要的 YAML 相關 CVE 都是 `yaml.load()` 注入。修補辦法是 `yaml.safe_load()`,但這個絆線仍然存在。
• 解析比 JSON 慢。以縮排為基礎的語法要求解析器追蹤欄位位置。同樣的資料 YAML 檔案解析速度比 JSON 慢 2-3 倍,這在每次請求都重新載入的熱點設定檔中會有影響。
5.3 2026 年何時使用 YAML
在以下場景使用 YAML:每個 Kubernetes 清單(`kubectl apply -f`)、每個 Docker Compose 檔、每個 GitHub Actions workflow(`.github/workflows/*.yml`)、每個 GitLab CI 流水線、每個 CircleCI 設定、每個 Ansible playbook、每個 Cloudflare Wrangler 設定、每個靜態網站產生器設定(Astro、Hugo、Jekyll、Eleventy)、每個 OpenAPI 3.0+ 規格、每個 GitHub Pages 設定,以及任何需要人手編輯的設定檔。當作者是人、消費者是機器時,YAML 是正確答案。
5.4 YAML 實戰程式碼
一個典型的 YAML 檔案長這樣。它是 CI/CD 流水線消費用來把容器部署到 Kubernetes 的檔案:
6. CSV:試算表的母語
CSV(Comma-Separated Values,逗號分隔值)是每個試算表、每個銀行對帳單、每個分析匯出、每個機器學習訓練集都已經會說的一種結構化資料格式。它是四種格式中 Excel、Google Sheets、Apple Numbers、LibreOffice Calc 以及地球上每個 BI 工具都能雙擊開啟的。它也是四種格式中最古老的——CSV 比 JSON、XML、YAML 早 20-30 年,並且毫無被淘汰的跡象。
6.1 CSV 的優勢
CSV 有四個結構優勢:
• 通用試算表支援。CSV 是四種格式中唯一能免轉換在 Excel、Google Sheets、Apple Numbers、LibreOffice Calc、Quip、Airtable、Notion(作為資料表匯入)以及每個 BI 工具(Tableau、Power BI、Looker、Metabase)中開啟的格式。
• 表格資料最小檔案大小。對於 100 萬列的表格,CSV 通常比等價 JSON 小 2-5 倍(因為沒有逐列語法額外負荷),比等價 XML 小 5-10 倍。
• 易於串流處理。CSV 是列導向的,這意味著你可以透過一次讀一列、用常數記憶體處理 10 GB 的 CSV 檔案。JSON、XML、YAML 都需要麼載入整個檔案,麼建構串流解析器。
• 天然適合 diff。兩個相同資料的 CSV 檔案只在變化列上有差異,這讓 `git diff` 按開發者預期那樣工作。JSON 與 YAML 的 diff 會被縮排和鍵順序變化主導;XML 的 diff 會被命名空間前綴和屬性順序主導。
6.2 CSV 的劣勢
CSV 有五個結構劣勢:
• 沒有巢狀結構。CSV 列是扁平的。要表達帶子項陣列的列(比如帶 3 個明細的訂單),你要麼複製父列、麼把子值合併到一個儲存格、麼用單獨的「子」CSV 並用外鍵連接。JSON 和 YAML 天然支援。
• 沒有註解。CSV 沒有註解語法。常見的變通是加一個 `_comment` 欄或單獨的 `schema.csv` 檔案,但都沒有標準化。
• 類型模糊。CSV 裡所有東西都是字串。一個叫 `price` 的欄可能是 `19.50`(數字)、`"$19.50"`(帶美元符號的字串)或 `19.5`(某些試算表會四捨五入到 20 的數字)。類型推斷是消費者的問題,這就是為什麼大多數 CSV 檔案最後都會有一個單獨的「schema」檔或文件化慣例。
• 編碼模糊。RFC 4180 指定 UTF-8,但 Excel 預設根據使用者地區設定用 Windows-1252 或 GBK 儲存 CSV,這意味著在 Excel 中開啟 CSV 經常出現亂碼。帶 BOM 的 UTF-8 是 2026 年最安全的編碼。
• 分隔符模糊。逗號是標準分隔符,但在小數分隔符是逗號的地區(大部分歐洲國家)Excel 會切換為分號。TSV(定位字元分隔)是跨區域更安全的選擇。
6.3 2026 年何時使用 CSV
在以下場景使用 CSV:每個 Excel / Google Sheets 匯出、每個銀行對帳單、每個 Stripe / Shopify / Square 撥款報告、每個 Google Analytics / Plausible / Matomo 匯出、每個 pandas / R / Stata / SPSS / SAS 資料集、每個機器學習訓練集(Kaggle、HuggingFace 資料集基本都是 CSV 或 Parquet)、每個面向非技術消費者的資料庫匯出、每個記錄檔、每個聯絡人清單、每個庫存清單,以及每個需要發給非開發者的資料集。當消費者是試算表或資料分析師,資料是扁平表時,CSV 是正確答案。
6.4 CSV 實戰程式碼
一個典型的 CSV 檔案長這樣。它是 Stripe 撥款匯出的檔案——第一列是欄名(「表頭」),後續每列是一筆記錄:
7. JSON、XML、YAML、CSV 之間如何轉換
對於四種格式都能表示的資料(沒有二進位區塊的扁平或巢狀資料),這四種格式可以互換。下面的六種轉換方向覆蓋 99% 的真實轉換需求,配四種最常用命令列工具的可複製命令:`jq` 處理 JSON,`yq` 處理 YAML,`xmlstarlet` 處理 XML,`pandas` 處理 CSV。四種都免費、都是開源、在所有作業系統上都能跑。
7.1 JSON 與 XML 互轉
JSON → XML 的最快命令列路徑是 `xmlstarlet`(Linux/macOS,免費,透過 apt/brew 安裝)。XML → JSON 的最近瀏覽器工具是 FileMarkd 的 XML 轉 JSON 轉換器,它在處理命名空間、屬性和混合內容方面比任何命令列工具都更準確。
如果想在瀏覽器裡做一次性的 JSON → XML 轉換,FileMarkd XML 轉 JSON 也支援反向轉換,能正確保留結構。如果用 Python:
7.2 JSON 與 YAML 互轉
`yq` 工具(來自 Mike Farah,即 YAML 版的 `jq`)是最快的路徑。它是單個 Go 二進位,免費,所有作業系統都可用。
7.3 CSV 與 JSON 互轉
CSV → JSON 的最快路徑是 `pandas`(Python)。JSON → CSV 可以再次使用 `pandas`,或在離開 shell 的情況下用 `jq` 的 `@csv` 篩選器一行搞定。
7.4 YAML 與 XML 互轉
沒有單個命令列工具能乾淨地往返 YAML ↔ XML,因為兩種格式並非 1:1 對應(XML 有屬性和混合內容,YAML 沒有)。最乾淨的路徑是 YAML → JSON → XML,使用上面兩條命令:
JSON → XML → JSON 僅當 XML 往返使用元素子節點(而非屬性)時無損。JSON → YAML → JSON 僅當你使用 `yq -P`(pretty 塊式)時無損,使用預設選項的 `yq -o=json` 不一定。任何格式 → CSV 總是有損,因為 CSV 無法表示巢狀結構。轉換完成後,務必對輸出與輸入做 diff,確認往返是乾淨的。
8. 決策指南:2026 年應該用哪種格式?
下表是對開篇問題的實踐回答。把你的場景對應到一行,採用推薦的格式。每一個推薦都是該領域最大生態已經會說的一種格式,所以你不需要在輸入和輸出兩端都付出轉換稅。
| 如果你需要…… | 使用 | 原因 | 推薦工具 |
|---|---|---|---|
| 交付 REST 或 GraphQL API 負載 | JSON | 每個 Web 用戶端、行動 SDK 和 HTTP 函式庫都原生解析 JSON | [[FileMarkd|/xml-to-json]] 用於 JSON 輸出端 |
| 把文件存到 MongoDB / Couchbase / Elasticsearch | JSON | 原生文件格式,無需轉換 | [[如何開啟 JSON 檔案|/articles/how-to-open-json-file]] |
| 使用 XSD schema 交換業務文件 | XML | 唯一具有一等命名空間 + schema 支援的格式 | [[FileMarkd XML 轉 JSON|/xml-to-json]] 用於 JSON 端 |
| 寫 Kubernetes 清單 | YAML | Kubernetes API 伺服器只接受 YAML / JSON;人更喜歡 YAML | yq 用於就地編輯 |
| 寫 GitHub Actions workflow | YAML | Runner 只讀 YAML | `act` 用於本地測試 |
| 在 Excel 或 Google Sheets 中開啟資料 | CSV | 雙擊開啟,無需匯入精靈 | pandas 用於往返 |
| 訓練機器學習模型 | CSV(或 Parquet) | 每個 ML 框架都讀 CSV;pandas DataFrame 是共通語 | pandas / DuckDB |
| 把資料集透過郵件發給非開發者 | CSV | Excel 與 Numbers 能開啟;它們打不開 JSON 或 YAML | Excel「另存為 CSV UTF-8」 |
| 在設定中嵌入多行 SQL 查詢 | YAML | 塊標量(`|`)是嵌入多行字串最乾淨的方式 | yq 用於驗證 |
| 為 Stripe、Shopify、Google Merchant Center 建立 feed | CSV(或 XML) | 大多數商品 feed 規範要求 CSV 或 XML;有些也接受 JSON | 查看規範,預設 CSV |
| 透過歐洲電子發票網路發送發票 | XML(UBL 2.1)或 JSON(Peppol) | 大多數網路要求 UBL XML;有些接受 Peppol JSON | 你的網路規範 |
| 把 10 GB 的分析匯出存到磁碟 | CSV(或 Parquet) | CSV 以常數記憶體串流處理;JSON 需要載入整個檔案 | pandas / DuckDB / Polars |
| 寫書或長篇手冊 | XML(DocBook)或 Markdown | 只有 XML 能處理文字與標籤混合;Markdown 可讀性更佳 | [[Markdown 檔案是什麼|/articles/what-is-markdown]] |
| 為程式碼產生定義 HTTP API 合約 | YAML(OpenAPI 3.0+)或 JSON | OpenAPI 以 YAML 為先;Swagger codegen 兩種都接受 | `openapi-generator` CLI |
| 在靜態網站產生器中儲存設定檔 | YAML | Astro、Hugo、Jekyll、Eleventy 都預設 YAML | 帶 YAML 擴充的編輯器 |
| 從 PDF 或 Word 產生乾淨的 Markdown 檔案 | Markdown | 這是人和 AI 最乾淨的長篇格式 | [[FileMarkd Word 轉 Markdown|/word-to-markdown]] |
| 為 AI / RAG 流水線產生結構化 JSON | JSON | 每個 LLM 內容視窗和向量儲存的原生格式 | [[FileMarkd XML 轉 JSON|/xml-to-json]] |
| 把設定檔交給非開發者同事 | YAML | 唯一一種非開發者無需培訓就能讀的格式 | yq + 程式碼審查工具 |
9. 常見問答
對「json vs xml vs yaml vs csv」搜尋結果中出現頻率最高的問題,給出簡短直接的答案。9.8 節的結尾段是整篇指南的結論。
9.1 JSON 正在取代 XML 嗎?
沒有,而且在 2015 年就已經不再嘗試取代。JSON 取代了 XML 在 Web API、行動 App 和 NoSQL 資料領域的地位。XML 守住了自己的地盤:企業文件交換、Office 檔案、醫療標準、政府申報、RSS/Atom 訂閱源和 SVG 影像。2026 年,兩種格式都在成長:JSON 因為每個新 App 和 API 都在用它;XML 因為 20 年前採用它的企業和政府生態沒有遷移也沒有打算遷移。「JSON vs XML」的框架是 2008 年的問題;2026 年的問題是「資料用 JSON,文件用 XML」。
9.2 YAML 比 JSON 更適合設定檔嗎?
是的,差距很大。YAML 支援註解(JSON 不支援)、原生支援多行字串(JSON 需要 ` ` 跳脫)、支援錨點和引用(JSON 不支援),而且能一眼讀懂,不需要數括號。JSON 在設定檔上唯一勝過 YAML 的地方是解析速度和解析器可用性,實際中兩者都可以忽略(YAML 檔案在個位數毫秒內載入)。對於任何需要人手編輯的設定檔,YAML 是正確答案。對於任何由程式產生、只由程式讀取的設定檔,JSON 也行。
9.3 2026 年什麼時候還應該用 CSV?
當消費者是試算表、資料分析師、非開發者或機器學習模型時,就用 CSV。CSV 是四種格式中唯一能免轉換在 Excel、Google Sheets、Apple Numbers、LibreOffice Calc、pandas、R、Stata、SPSS、SAS、Tableau、Power BI、Looker、Metabase 以及其他每個資料工具中開啟的。如果你匯出的資料集要離開你的系統,CSV 幾乎總是正確選擇。CSV 不適用的兩種情況:(1) 你的資料是巢狀的(帶多個明細的訂單)——用 JSON 或 XML;(2) 檔案會被需要註解的開發者編輯——用 YAML。
9.4 哪種格式解析最快?
CSV 最快,因為它是列導向的,不需要驗證結構。JSON 緊隨其後,通常對同樣資料比 CSV 慢 2-3 倍,因為解析器要驗證括號和類型。YAML 緊隨其後,通常比 JSON 慢 2-3 倍,因為以縮排為基礎的語法要求追蹤欄位。XML 最慢,通常比 JSON 慢 3-10 倍,因為解析器要建構 DOM 並驗證格式良好性。對每秒解析數千個檔案的高吞吐服務來說,這個排序有意義;對典型設定檔和一次性 API 呼叫來說,無所謂。
9.5 哪種格式最適合 API?
JSON。每個 HTTP 函式庫、每個行動 SDK、每個 JavaScript 前端、每個 LLM 內容視窗以及生產環境中的每個 API 閘道都已經會說 JSON。只有在你必須支援遺留 SOAP 端點、使用 XSD schema 的企業整合或 HL7 / FHIR 這樣的醫療標準時,XML 才是答案。2026 年的新 API,JSON 是預設;YAML 只對永不改變形狀的讀密集設定型端點可接受。
9.6 哪種格式最適合設定檔?
人手編輯的設定檔用 YAML(Kubernetes、GitHub Actions、Docker Compose、Ansible、Cloudflare Wrangler)。程式產生、程式讀取的設定檔用 JSON(npm 的 `package.json`、VS Code 的 `settings.json`、瀏覽器的 `manifest.json`、每個 CI/CD 製品)。TOML 是值得尊敬的第三選擇,它把 YAML 的可讀性與 JSON 的明確性結合在一起,是 Cargo(Rust)、pyproject.toml(Python)以及許多較新工具的預設。CSV 永遠不是設定格式。
9.7 哪種格式最適合試算表?
CSV。它是四種格式中唯一能雙擊在試算表中開啟的。如果資料是巢狀的(帶多個明細的訂單、帶多個地址的客戶),把它拍扁成父 CSV 和子 CSV,並用外鍵連接——這是試算表的標準資料建模模式。如果試算表需要公式和條件格式,改為交付 `.xlsx`(它是 XML 的 ZIP);使用者之後仍然可以匯出為 CSV。
9.8 能把這幾種格式混著用嗎?
可以——而且你很可能已經在這樣做了。典型的現代技術棧對 Kubernetes 清單用 YAML,對 REST API 用 JSON,對企業整合和 Office 文件用 XML,對分析匯出和機器學習資料集用 CSV。第 7 節的轉換方法用一兩個命令列工具覆蓋了每一種相互轉換的路徑。本指南的結論:2026 年「JSON vs XML vs YAML vs CSV」是錯誤的問題。正確的問題是「我的流水線其他環節已經說哪種語言?」,而答案通常是「四個都會說,在不同地方」。
更多關於驅動現代知識工作的開放格式,請閱讀我們的 JSON 檔案如何開啟、Markdown 檔案是什麼 以及 RTF 檔案是什麼 指南。