JSON CSV 変換ツール

JSON to CSV コンバーターは、階層構造を持つJavaScript Object Notation (JSON) をフラットな2次元のカンマ区切り値 (CSV) スプレッドシートに変換します。JSONはWeb APIやNoSQLデータベースの共通規格であり、CSVはExcelやGoogleスプレッドシート、リレーショナルDB取り込みの標準形式です。本Webツールはすべての変換処理をブラウザ内で完結させ、サーバーへのファイルアップロードや会員登録、ファイルサイズ制限なしで安全に利用できます。

JSONをCSVに変換する手順

JSONからCSVへの変換はシンプルな3つのステップで行えます：

1. JSONデータの読み込み： JSONテキストの直接貼り付け、.json / .jsonl ファイルのアップロード、または公開URLからの取得に対応。オブジェクト配列や2次元配列、ネスト構造を自動解析します。
2. 列構成の確認とプレビュー： 検出された全フィールドが型や出現率とともにプレビューテーブルに表示されます。列の名前変更、順序入れ替え、除外、区切り文字（カンマ、セミコロン、タブ、パイプ）の選択が可能です。
3. CSVまたはExcel形式でダウンロード： 標準CSV、UTF-8 BOM付きExcel対応CSV、または本物のMicrosoft Excel .xlsx ワークブックとして即座にダウンロードできます。

ネストされたJSONのCSV変換

JSONは階層的なツリー構造ですが、CSVはフラットな行列構造です。ネストされたデータを変換する際、末端の各プロパティは customer.address.city のように完全パスで名前付けされた独立した列へとフラット化されます。パス区切り文字（ドット、アンダースコア、スラッシュ）のカスタマイズや最大深度の設定、深いオブジェクトのJSONテキスト保持にも対応しています。

JSON配列とオブジェクトの取り扱い

JSON内の配列データを1つのセルに収めるには適切な変換ルールが必要です。本コンバーターは4つの展開戦略を提供しています：

• インデックスごとの列分割： items.0、items.1 のようにインデックス別の独立した列を生成します。要素数が固定されたリストに最適です。
• 要素ごとに行分割（Unwind）： 配列の各要素に対して親フィールドの値を複製し、複数行に展開します。SQLリレーショナルテーブルの標準形式です。
• 結合セル： セミコロンやパイプなどの区切り文字で要素を連結し、1つのクォートセルにまとめます（例: "tag1; tag2"）。
• 生のJSON文字列： ["tag1", "tag2"] をパース前のJSONリテラルのままCSVセルに保持します。

JSONからCSVへの変換例

顧客の注文データをテーブル形式に変換する代表的な例です：

[
  {
    "orderId": "ORD-2048",
    "customer": { "name": "Elena Rostova", "email": "elena@example.com" },
    "total": 149.50,
    "status": "shipped"
  },
  {
    "orderId": "ORD-2049",
    "customer": { "name": "Marcus Vance", "email": "marcus@example.com" },
    "total": 89.00,
    "status": "pending"
  }
]

コンバーターは両方のレコードを走査してすべてのフィールドを含む統一ヘッダーを作成し、ネストされた customer オブジェクトを展開して整形されたCSVを出力します：

orderId,customer.name,customer.email,total,status
ORD-2048,Elena Rostova,elena@example.com,149.5,shipped
ORD-2049,Marcus Vance,marcus@example.com,89,pending

JSONとCSVの主な違い

JSONとCSVの構造的な違いを把握することで、適切な変換タイミングを判断できます：

PythonによるJSONからCSVへの変換（pandasまたは標準ライブラリ）

Pythonスクリプトでパイプライン処理を自動化する場合、pandasを使えばわずか3行で展開できます：

import json

import pandas as pd

with open("input.json", encoding="utf-8") as handle:
    data = json.load(handle)

frame = pd.json_normalize(data, sep=".")
frame.to_csv("output.csv", index=False)

外部ライブラリを入れずに標準ライブラリ（json と csv.DictWriter）のみで実装することも可能です。※64ビット整数の精度落ちを防ぐため、json.load には parse_int=str の指定を推奨します。

Node.jsによるJSONからCSVへの変換

Node.js環境では、外部npmパッケージに依存することなく標準モジュールだけで変換できます：

import { readFile, writeFile } from 'node:fs/promises';

const data = JSON.parse(await readFile('input.json', 'utf8'));
const fields = [...new Set(data.flatMap((row) => Object.keys(row)))];

const cell = (value) => {
  const text = value == null ? '' : String(value);
  return /[",\n]/.test(text) ? '"' + text.replaceAll('"', '""') + '"' : text;
};

const csv = [fields, ...data.map((row) => fields.map((field) => row[field]))]
  .map((row) => row.map(cell).join(','))
  .join('\n');

await writeFile('output.csv', csv, 'utf8');

完全無料・容量無制限の理由

一般的なWebコンバーターはファイルを外部サーバーにアップロードするため、通信費やサーバー維持費を賄うための利用制限や有料プランが存在します。jsoncsvonline はWeb Workerを活用して100%ブラウザローカルで動作するため、サーバーへの通信が一切発生せず、容量制限や待ち時間を設ける必要がありません。詳細については ネストされたJSONのフラット化ガイド、JSON配列の変換手法、および Excel互換のCSV文字コード・区切り文字設定 をご覧ください。

変換前のJSON検証・整形・自動修復

CSVやExcelへ変換する前に構文の妥当性を確認することで、変換エラーを未然に防止できます。構文エラーの検査には JSONバリデーター、欠落したクォートや末尾カンマの自動修正には JSON修復ツール、階層の整形には JSONフォーマッター、差分の比較には JSON差分比較ツール、本番用API向けの圧縮には JSONミニファイア を併せてご活用ください。