JSON vs XML vs YAML vs CSV:どれを使うべきか?
JSON、XML、YAML、CSV は、2026 年にすべての開発者、データアナリスト、テクニカルライターが遭遇する 4 つの構造化データフォーマットです。それぞれが異なる問題を解決するために作られ、どれも消えていません。実問題は「どれが最高か」ではなく「目の前のワークフローにどれが合うか」です。本ガイドは、30 秒の判断フレーム、横並び比較表、各フォーマットの強みと弱みの深掘り、実コードサンプル、コピー&ペースト可能な相互変換レシピ 6 種、そして 2026 年のすべての一般的な状況に対して適切なフォーマットを選ぶ決定表を提供します。

1. JSON vs XML vs YAML vs CSV:2026 年はどれを使うべきか?
JSON vs XML vs YAML vs CSV の比較に単一の勝者はいません。4 つのフォーマットはそれぞれ異なる 10 年に異なる問題のために作られ、2026 年にも本番環境で使われ続けているのは、4 つのうちどれか 1 つが他の 3 つの仕事を引き受けられないからです。このセクションの役目は、30 秒で答えを出して、本物の必要に応じた変換レシピや用途別決定表へジャンプしてもらうことです。
最短版:ネットワーク越しにデータを送ったりドキュメントデータベースに格納するなら JSON。スキーマ、名前空間、混在コンテンツが必要な文書を交換するなら XML。設定ファイルを人が手で編集するなら YAML。スプレッドシートでファイルを開くなら CSV。本ガイドの残り部分は、この 4 文のロングバージョンとその裏付けです。
1.1 30 秒の判断フレーム
今やっている作業に該当する 4 行を読んでください。
• 「API またはモバイルアプリを構築している」→ JSON。Web の共通語であり、すべての言語に組み込みパーサーがあり、すべての HTTP クライアントがネイティブに理解します。
• 「XSD スキーマが必要なビジネス文書、法務書面、またはスキーマが必要な何かを交換している」→ XML。4 つのうち唯一、名前空間、混在コンテンツ、機械可読スキーマ検証をネイティブにサポートします。
• 「人が手で編集する設定ファイルを書いている」→ YAML。インデントベースの構文は大綱のように読め、コメントをサポートし、Kubernetes、GitHub Actions、Docker Compose、Ansible のデフォルトです。
• 「スプレッドシートへのインポート/エクスポートをしている」→ CSV。4 つのうち唯一、Excel、Google Sheets、Apple Numbers、そして地球上のすべての BI ツールが変換なしで開けます。
1.2 4 つのフォーマットの簡単な歴史
XML は 1998 年に W3C が公開した、初期 Web の構造化文書フォーマットです。SOAP、RSS、XHTML、Office Open XML のおよそ 10 年間における共通語でした。CSV は XML より約 25 年早く、1979 年の初代 VisiCalc の登場以来スプレッドシートの母語であり、この 4 つの中で唯一「設計された」のではなく「人がテキストファイルにデータの行を入力するやり方から自然に生まれた」フォーマットです。JSON は 2001 年に Douglas Crockford が XML の JavaScript フレンドリーな代替として普及させ、2008 年の iPhone 登場で REST API がデフォルトになった後に Web を席巻しました。YAML は 2001 年に "YAML Ain't Markup Language" として公開されました — Python のインデントのアイデアと Perl のシャープコメントのスタイルを借りた、人間に優しい設定構文です。
4 つのフォーマットは互いに取って代わったというより、世界を 4 つの重なる領域に分割しました:文書(XML)、Web API(JSON)、設定(YAML)、表形式データ(CSV)。2026 年においてもこの 4 つの領域はこの 4 つの領域であり、4 つのフォーマットはこの 4 つのフォーマットです。
1.3 なぜ 4 つすべてが 2026 年も生き残っているのか
4 つのフォーマットを本番環境に留めている 3 つの構造的理由:
• それぞれが別の仕事に対する最安値のツール。JSON はネットワークデータ伝送の最安値フォーマット(パーサーが極小)。XML は文書フォーマットの最安値(名前空間、スキーマ、混在コンテンツを持つ)。YAML は設定フォーマットの最安値(人が読んで編集でき、ミスしにくい)。CSV は表形式データの最安値(地球上のすべてのスプレッドシートが変換なしで開ける)。
• パーサーが成熟し普遍的に利用可能。すべての近代言語が 4 つすべての標準ライブラリパーサーを同梱しています。Python、JavaScript、Java、C#、Go、Rust はどれも追加ライブラリなしで読み取れます。
• スイッチングコストはゼロ、生態系コストは巨大。JSON ファイルを YAML に変換するのは 1 行のコマンド。AWS エコシステム全体を JSON から XML に移行するのは 10 年プロジェクト。4 つのフォーマットが存続するのは、それを取り巻くエコシステムが存続しているからです。
1.4 2026 年に誰がどのフォーマットを使っているか
• JSON — すべての REST API、すべてのモバイルアプリ、すべての 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 ワークフロー、すべての Ansible Playbook、すべての CircleCI / GitLab CI パイプライン、すべての Cloudflare Workers wrangler.toml、そしてほとんどの近代的静的サイト設定ファイル(Astro、Hugo、Jekyll)。
• CSV — すべての銀行取引明細、すべての Excel エクスポート、すべての Google Sheets ダウンロード、すべての Stripe ペイアウト、すべての Shopify プロダクトフィード、すべての Google Analytics エクスポート、すべての pandas / R / Stata / SPSS データセット、そして世界中のすべての機械学習トレーニングセット。
2026 年において「JSON vs XML」は間違った質問です — 正しい質問は「私のパイプラインの他の部分はすでにどの言語を話しているか?」。既存のツール、チームの習熟度、下流の消費者にそのまま流し込めるフォーマットを選んでください。変換はいつでも 1 行のコマンド。生態系の不一致は何ヶ月もかかります。
2. 横並び比較表
以下の表は 2026 年の 4 つのフォーマットの正典リファレンスです。選んだ次元は実際に判断を変えるもの:可読性、構造、ツール、フィット感。判断を変えない次元(発明年、元の著者)は 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` キー) | あり(`<!-- -->`) | あり(`#`) | なし(回避:別カラム) |
| スキーマ検証のサポート | あり(JSON Schema 2020-12) | あり(XSD 1.1、RelaxNG、Schematron) | なし(YAML には公式スキーマなし) | なし |
| バイナリデータのサポート | Base64 エンコード文字列のみ | Base64 または 16 進数 | Base64 エンコード文字列のみ | なし(テキストのみ) |
| 末尾カンマの可否 | 不可 | 不可(ただし空白は寛容) | 不可 | 不可(Excel のインポートエラーの原因) |
| 同データでのファイルサイズ | 最小 | 最大(JSON の 3〜5 倍) | JSON の 2〜3 倍(インデント) | フラットな表では最小 |
| 解析速度(典型) | 最速 | 最遅(XML は解析が最も重い) | 中(インデント解析が追加コスト) | 最速(行ごと) |
| 既定の用途 | Web API、NoSQL、AI コンテキスト | 文書、SOAP、スキーマ、RSS | 設定ファイル、CI パイプライン、K8s | スプレッドシート、データセット、エクスポート |
| Excel / Sheets ネイティブ | なし(インポート必要) | なし(インポート必要) | なし(インポート必要) | あり(ダブルクリックで開く) |
| 最適な用途 | マシン間のデータ交換 | スキーマ付き文書交換 | 人手編集する設定ファイル | 表形式データとエクスポート |
3. JSON:Web の万能データフォーマット
JSON(JavaScript Object Notation)は、すべての Web API、すべてのモバイルアプリ、すべての NoSQL データベース、すべての近代的 AI コンテキストウィンドウがすでに話している構造化データフォーマットです。マシン間の通信のデフォルト選択であり、XML や YAML の儀式なしに人が構造化データを読んだり書いたりする際の最もポピュラーな選択でもあります。
3.1 JSON の強み
JSON には 2026 年における支配を説明する 6 つの構造的利点があります:
• 極小のパーサー。すべての近代言語が標準ライブラリに JSON パーサーを内蔵しています。Python の `json` モジュール、JavaScript の `JSON.parse`、Go の `encoding/json` パッケージ、Java の `jackson-databind` ライブラリ、Rust の `serde_json` crate、C# の `System.Text.Json` はすべて言語に同梱され、インストール不要です。
• コンパクトな構文。典型的な構造化データに対して、JSON は 4 つのうち最もコンパクトです。同じペイロードが JSON だと 100 KB なら、XML では 300〜500 KB、YAML では 200〜300 KB になります。
• Web ブラウザにネイティブ。JavaScript は 1 つの関数呼び出し(`JSON.parse`)で JSON を解析し、別の 1 つ(`JSON.stringify`)でシリアライズできます。このリストの他のフォーマットにこの特性はありません。
• スキーマ不要。スキーマを先に定義しなくても有効な JSON を配信できます。これは早期段階の API に対する JSON の最大の生産性上の利点です。
• ドキュメントデータベースに最適。MongoDB、Couchbase、Elasticsearch、Cosmos DB、DynamoDB はすべて JSON をネイティブに格納します。PostgreSQL は 2014 年にファーストクラスの JSON と JSONB サポートを追加しました。
• AI / LLM コンテキストウィンドウに最適。すべての近代 LLM は JSON に基づいて学習され、コンテキストウィンドウ内で JSON を理解します。XML、YAML、CSV も認識されますが、JSON は 4 つのうち LLM 学習データで普遍的にファーストクラスである唯一のフォーマットです。
3.2 JSON の弱み
JSON には 4 つの構造的欠点があります:
• コメントがない。公式 JSON 仕様(RFC 8259)はコメントを許可しません。JSON5、JSONC、末尾カンマ付き JSON は拡張として存在しますが、厳密なパーサーとは互換性がありません。
• スキーマ強制がない。JSON Schema は存在しますが、フォーマットの一部ではありません。本番環境の JSON ファイルのほとんどは、スキーマではなく手書きのコードで検証されています。
• 名前空間がない。同じ文書内の 2 つの異なる `id` フィールドは、名前空間プレフィックスではなく手動で(例:`user_id` と `order_id`)区別する必要があります。
• 混在コンテンツがない。JSON は「<b>セクション 2</b> を参照」のようなテキストとタグが混在する内容を、テキストノードのツリーに分割しない限り表現できません。
3.3 2026 年に JSON を使うとき
次の場合に JSON を使用:すべての REST API、すべての GraphQL API、すべての WebSocket メッセージ、すべてのモバイルアプリペイロード、すべての NoSQL ドキュメント、すべてのイベントストリームメッセージ(Kafka、Kinesis、Pub/Sub)、コメントが不要なすべての設定ファイル、すべての AI / LLM プロンプトと応答、ドキュメントデータベースへのすべてのデータエクスポート、すべての JavaScript フロントエンド状態ツリー、すべての CI/CD アーティファクト。コンシューマがプログラムでプロデューサもプログラムであるときは、JSON が正解です。
3.4 実コードで見る JSON
典型的な JSON ファイルはこんな感じです。REST API が 1 つの顧客注文に対して返すペイロード:
4. XML:エンタープライズ文書の標準
XML(Extensible Markup Language)は、2026 年においてもすべてのエンタープライズ統合、すべての Office 文書、すべての医療標準、すべての政府データ交換が依存する構造化データフォーマットです。4 つのうち最も重く最も冗長ですが、名前空間、スキーマ、混在コンテンツ、そして書籍や法務契約書、SOAP エンベロープに必要な文書構造をサポートするのは 4 つのうち唯一 XML だけです。
4.1 XML の強み
XML には 30 年間で淘汰されなかった理由を説明する 5 つの構造的利点があります:
• 名前空間。2 つの異なる `id` 属性は、XML Namespaces 1.0 仕様によって `<order:id>` と `<customer:id>` として区別できます。JSON、YAML、CSV には同等機能がありません。
• スキーマ。XML には競合する 3 つのスキーマ言語(XSD 1.1、RelaxNG、Schematron)があり、W3C XML Schema 標準は世界で最も広く展開されているスキーマ言語です。XSD を使うと、`price_usd` 要素が 0〜999999 の小数であり、`email` が正規表現に一致し、`items` が正確に 1〜100 個の `item` 子要素を含むことなどを指定できます。このリストの他のフォーマットには同等の検証ストーリーがありません。
• 混在コンテンツ。XML は「<b>セクション 2</b> を参照」のように、テキストとタグが交互に現れる内容をネイティブに表現できます。JSON には不可能です。YAML にも不可能です。CSV にも不可能です。これが XML が書籍、法務契約書、技術文書の唯一の実行可能なフォーマットである理由です。
• XSLT、XPath、XQuery。XML には W3C 標準スタックに組み込まれた 3 つのクエリと変換言語があります。JSON には JSONPath があります(コミュニティ標準であり W3C 標準ではありません)。YAML には何もなく、CSV にも何もありません。XML のクエリと変換のエコシステムは、桁違いに深いです。
• 至る所に存在。すべての近代的なワープロ、表計算、プレゼンテーションアプリは、ファイルを XML の ZIP(Office Open XML)として保存します。すべての SVG 画像は XML です。すべての EPUB 電子書籍は XML の ZIP です。すべての SOAP エンベロープは XML です。すべての RSS と Atom フィードは XML です。このフォーマットが見えないのは、それだけ深く埋め込まれているからです。
4.2 XML の弱み
XML には 4 つの構造的欠点があります:
• 冗長。同じペイロードが 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、EU 電子請求書)、すべての Office 文書(.docx、.xlsx、.pptx は XML の ZIP)、すべての SVG 画像、すべての EPUB 電子書籍、すべての RSS / Atom フィード、厳密な XSD スキーマが必要なすべての文書、XSLT を使うすべての変換パイプライン、テキストとタグが混在するコンテンツを含むすべての文書(書籍、法務契約書、技術マニュアル)。コンシューマがデータレコードではなく文書であるときは、XML が正解です。
4.4 実コードで見る XML
典型的な XML ファイルはこんな感じです。SOAP エンドポイントが 1 枚の請求書に対して返すペイロードで、名前空間とスキーマ参照を含みます:
5. YAML:人間にやさしい設定フォーマット
YAML(YAML Ain't Markup Language、元は "Yet Another Markup Language")は、2026 年にすべての近代的設定ファイル、すべてのコンテナオーケストレーションツール、すべての CI/CD パイプラインが使う構造化データフォーマットです。最初の日から人間による読み書きを念頭に設計された 4 つのうち唯一のもので、それゆえに Kubernetes、Docker Compose、GitHub Actions、Ansible、Cloudflare Wrangler のデフォルトになりました。
5.1 YAML の強み
YAML には 4 つの構造的利点があります:
• ベストクラスの人にとっての可読性。YAML はアウトラインのように読め、インデントが構造を示します。JSON で 20 行かかるデータが YAML では 10 行で済み、括弧を数えずに一目で読めます。
• ファーストクラスのコメント。YAML はファイルの任意の場所で `#` コメントをサポートし、ほとんどのエディタが正しくハイライトします。JSON はコメントをサポートせず、CSV もサポートせず、XML はコメントをサポートしますが `<!-- -->` の構文がぎこちない。
• ファーストクラスの複数行文字列。YAML は折りたたみ(`>`)とリテラル(`|`)のブロックスカラーをサポートし、複数行文字列、SQL クエリ、秘密鍵を設定ファイルに埋め込む最もクリーンな方法です。JSON は ` ` エスケープが必要で、XML は CDATA が必要で、CSV はそもそもできません。
• ファーストクラスの参照。YAML はアンカー(`&`)とエイリアス(`*`)をサポートし、値を 1 回定義して複数箇所で参照できます。JSON には同等機能なく、XML にはエンティティがありますがぎこちなく、CSV には同等機能ありません。
5.2 YAML の弱み
YAML には 4 つの構造的欠点があります:
• 空白に敏感。スペースやタブ 1 個の置き間違いで文書が壊れます。YAML はインデントでのタブを完全に禁止しており、Web ページや IDE の自動インデント機能からのコピー&ペーストでハマります。
• 同じデータに複数の書き方。YAML にはフロー形式(`{a: 1, b: 2}`)とブロック形式(`a: 1 b: 2`)があります。複数行文字列が 2 種類あり、ブール値が 2 種類あります(`true` と `yes`)。人にとっては便利、パーサーにとっては悪夢です。
• セキュリティリスク:`unsafe_load`。Python の `yaml.load()` 関数は `Loader` 引数なしで任意の Python コードを実行します。过去 10 年間のすべての主要な 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 ワークフロー(`.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 ツールがダブルクリックで開ける 4 つのうち唯一のフォーマットです。また、最も古く、JSON、XML、YAML より 20〜30 年先輩で、消える気配もありません。
6.1 CSV の強み
CSV には 4 つの構造的利点があります:
• 普遍的なスプレッドシートサポート。CSV は、Excel、Google Sheets、Apple Numbers、LibreOffice Calc、Quip、Airtable、Notion(テーブルとしてインポート)、およびすべての BI ツール(Tableau、Power BI、Looker、Metabase)で変換なしに開ける 4 つのうち唯一のフォーマットです。
• 表形式データで最小のファイルサイズ。100 万行の表に対して、CSV は通常、同等の JSON より 2〜5 倍小さく(行ごとの構文オーバーヘッドがないため)、同等の XML より 5〜10 倍小さくなります。
• ストリーミングにやさしい。CSV は行指向なので、10 GB の CSV ファイルを 1 行ずつ読み、定数メモリで処理できます。JSON、XML、YAML はいずれもファイル全体を読み込むか、ストリーミングパーサーを構築する必要があります。
• 自然に diff 可能。同じデータの 2 つの CSV ファイルは変更行だけが異なるため、`git diff` は開発者の期待どおりに動作します。JSON と YAML の diff はインデントとキーの順序に左右され、XML の diff は名前空間プレフィックスと属性の順序に左右されます。
6.2 CSV の弱み
CSV には 5 つの構造的欠点があります:
• ネスト構造がない。CSV 行はフラットです。項目の配列を持つ行(3 つの明細を持つ注文など)を表現するには、親行を複製するか、子の値を 1 つのセルに連結するか、別の「子」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 で開くと文字化けがよく起こります。2026 年では BOM 付き UTF-8 が最も安全なエンコーディングです。
• 区切り文字の曖昧さ。カンマが標準の区切り文字ですが、小数点区切りがカンマであるロケール(ヨーロッパの多く)では 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 ペイアウトエクスポートが生成するファイルで、最初の行が列名(「ヘッダー」)、以降の各行が 1 件のレコードです:
7. JSON、XML、YAML、CSV 間の相互変換
4 つのフォーマットすべてが表現できるデータ(バイナリブロブを含まないフラットまたはネストしたデータ)に対して、4 つは交換可能です。以下の 6 つの変換方向は、現実の変換ニーズの 99% をカバーし、最も一般的な 4 つのコマンドラインツールのコピー&ペースト可能なコマンドを添えています:JSON 用 `jq`、YAML 用 `yq`、XML 用 `xmlstarlet`、CSV 用 `pandas`。すべて無料で、すべてオープンソースで、すべての OS で動作します。
7.1 JSON ↔ XML
JSON → XML の最速のコマンドライン経路は `xmlstarlet`(Linux/macOS、無料、apt/brew でインストール)です。XML → JSON については、FileMarkd の XML → JSON 変換ツールが最も近く、ブラウザツールであり、名前空間、属性、混在コンテンツをどのコマンドラインツールよりも正しくラウンドトリップします。
ブラウザで 1 回限りの JSON → XML 変換には、FileMarkd XML → JSON も逆方向をサポートし、構造を正しく保ちます。Python の場合:
7.2 JSON ↔ YAML
`yq` ツール(Mike Farah 作、YAML 版の `jq`)が最速の経路です。単一の Go バイナリで、無料で、すべての OS で利用可能です。
7.3 CSV ↔ JSON
CSV → JSON の最速の経路は `pandas`(Python)です。JSON → CSV は再び `pandas` を使うか、シェルから出ずに `jq` の `@csv` フィルタでワンライナーで処理できます。
7.4 YAML ↔ XML
2 つのフォーマットは 1:1 で対応していないため(XML には属性と混在コンテンツがあり、YAML にはありません)、YAML ↔ XML をクリーンにラウンドトリップする単一のコマンドラインツールはありません。最もクリーンな経路は YAML → JSON → XML で、上記 2 つのレシピを使用します:
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]] |
| MongoDB / Couchbase / Elasticsearch にドキュメントを格納する | JSON | ネイティブドキュメント形式、変換不要 | [[JSON ファイルの開き方|/articles/how-to-open-json-file]] |
| XSD スキーマでビジネス文書を交換する | XML | ファーストクラスの名前空間 + スキーマサポートを持つ唯一のフォーマット | JSON 側は [[FileMarkd XML → JSON|/xml-to-json]] |
| Kubernetes マニフェストを書く | YAML | Kubernetes API サーバーは YAML / JSON のみ受け付ける。人は YAML を好む | その場編集は yq |
| GitHub Actions ワークフローを書く | YAML | ランナーは 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 のフィードを作る | CSV(または XML) | ほとんどの商品フィード仕様は 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 は Web API、モバイルアプリ、NoSQL データの領域で XML に取って代わりました。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 ファイルは 1 桁ミリ秒でロードされます)。人が手で編集する設定ファイルには 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、そしてその他のすべてのデータツールで変換なしに開ける 4 つのうち唯一のフォーマットです。システムを離れていくデータセットをエクスポートするなら、ほぼ常に CSV が正しい選択です。CSV が不適切な 2 つの状況:(1) データがネストしている(複数の明細を持つ注文) — JSON または XML を使う、(2) コメントが必要な開発者がファイルを編集する — YAML を使う。
9.4 どのフォーマットが最も速く解析できる?
CSV が最速です。行指向で、構造を検証する必要がないためです。JSON が次、同じデータで通常 CSV より 2〜3 倍遅く、括弧と型を検証する必要があるためです。YAML が次で、通常 JSON より 2〜3 倍遅く、インデントベースの構文が列追跡を必要とするためです。XML が最遅で、通常 JSON より 3〜10 倍遅く、DOM 構築と整形式検証が必要なためです。1 秒あたり数千ファイルを解析する高スループットサービスではこの順序が問題になりますが、典型的な設定ファイルや 1 回限りの API 呼び出しでは問題になりません。
9.5 API に最適なフォーマットは?
JSON。すべての HTTP ライブラリ、すべてのモバイル SDK、すべての JavaScript フロントエンド、すべての LLM コンテキストウィンドウ、本番環境のすべての API ゲートウェイがすでに JSON を話しています。レガシー SOAP エンドポイント、XSD スキーマを使うエンタープライズ統合、または 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 は名誉ある第 3 の選択肢で、YAML の可読性と JSON の明確さを組み合わせ、Cargo(Rust)、pyproject.toml(Python)や多くの新しいツールのデフォルトです。CSV は決して設定ファイルにはなりません。
9.7 スプレッドシートに最適なフォーマットは?
CSV。ダブルクリックでスプレッドシートで開ける 4 つのうち唯一のフォーマットです。データがネストしている(複数の明細を持つ注文、複数の住所を持つ顧客)場合は、親 CSV と子 CSV にフラット化し、外部キーで結合してください — これがスプレッドシートの標準的なデータモデリングパターンです。スプレッドシートに数式と条件付き書式が必要な場合は、代わりに `.xlsx`(XML の ZIP)を納品してください。ユーザは後で CSV にエクスポートできます。
9.8 これらのフォーマットを混在させて使えますか?
はい — そしてあなたもすでにそうしているはずです。典型的な現代スタックは Kubernetes マニフェストには YAML、REST API には JSON、エンタープライズ統合と Office 文書には XML、分析エクスポートと機械学習データセットには CSV を使います。7 節の変換レシピは、1〜2 個のコマンドラインツールですべての相互変換パスをカバーしています。本ガイド全体の結論:2026 年において「JSON vs XML vs YAML vs CSV」は間違った質問です。正しい質問は「私のパイプラインの他の部分はすでにどの言語を話しているか?」であり、その答えは通常「4 つすべてを、異なる場所で」です。
現代の知識作業を支えるオープンフォーマットについて詳しくは、JSON ファイルの開き方、Markdown ファイルとは、RTF ファイルとは のガイドもご覧ください。