JSONとCSVの変換方法は?入れ子の扱いとExcelで文字化けしないコツ

APIから取ってきたデータはJSON、でも表計算ソフトで見たいのでCSVにしたい。そんな場面は多いです。この記事では、JSONとCSVの違い、変換のしくみ、つまずきやすい点を短くまとめます。
JSONとCSVの違い
| JSON | CSV | |
|---|---|---|
| 形 | キーと値のペア。入れ子にできる | 行と列だけの表 |
| 向いている用途 | APIのやり取り、設定 | Excelなどで一覧を見る・集計する |
| 型 | 数字・文字・真偽などを区別できる | すべて文字として扱われる |
JSONは「構造をもつデータ」、CSVは「平らな表」です。ここが、変換でつまずく原因になります。
変換のしくみ(JSON → CSV)
いちばん変換しやすいのは、同じ形のオブジェクトが並んだ配列です。
[
{"name": "田中", "age": 30},
{"name": "佐藤", "age": 25}
]
これは次のCSVになります。
name,age
田中,30
佐藤,25
キーが1行目(ヘッダー)になり、1つのオブジェクトが1行になります。オブジェクトごとにキーが違うときは、すべてのキーを集めて列にし、無い部分は空欄にします。
つまずきやすい3つのポイント
1. 入れ子のデータ
{"name": "田中", "address": {"city": "東京"}} のように中にオブジェクトがあると、そのままでは1つの表になりません。よくある対処は次の2つです。
- 中身を
address.cityのようにキーをつないで列にする(平らにする) - 1つのセルに文字列としてまとめて入れる
あとで集計したいなら、平らにする方が使いやすいです。
2. カンマ・改行・引用符を含む文字
値の中にカンマや改行があると、列がずれます。その値はダブルクォート(")で囲み、中のダブルクォートは2つ重ねて書きます。(例: "He said ""hi""")
3. 数字の先頭のゼロ
"00123" のような郵便番号や商品コードは、Excelで開くと 123 に変わることがあります。CSVの時点ではゼロは残っているので、Excelの取り込み機能で列を「文字列」に指定して読み込むと防げます。
ExcelでCSVが文字化けするとき
日本語版のExcelは、CSVを昔ながらの文字コード(Shift_JIS)として開こうとすることがあります。そのため、UTF-8で保存されたCSVを直接ダブルクリックで開くと、日本語が化けることがあります。対処は次のとおりです。
- BOM付きUTF-8で保存する: ファイルの先頭に目印(BOM)を付けると、ExcelがUTF-8だと判別できます。テキストエディタの「UTF-8 (BOM付き)」で保存し直せます。
- 取り込み機能を使う: Excelの「データ」タブから「テキストまたはCSVから」を選び、文字コードに UTF-8 を指定して読み込みます。
- Shift_JISで書き出す: 相手がExcelだけなら選べますが、一部の特殊な漢字や記号が変換できないことがあります。
新しいバージョンのExcelではUTF-8のCSVをそのまま開けることもありますが、環境によって違います。化けたら上の方法を試してください。
ブラウザで手軽に変換する
コードを書くほどでもない、1回だけ変換したい、というときはJSON ↔ CSV 変換ツールが便利です。JSONを貼り付けるとCSVに、CSVを貼り付けるとJSONに変換できます。ブラウザの中だけで動くので、手元のデータを気軽に試せます。
変換前にJSONの書き方が正しいか確認したいときは、JSON整形で検証してから使うと安心です。エラーがあれば場所のヒントも出ます。
まとめ
- JSON → CSVは「同じ形のオブジェクトの配列」がいちばん簡単
- 入れ子は、平らにするか1セルにまとめるかを先に決める
- カンマ・改行・引用符を含む値はダブルクォートで囲む
- Excelで化けたら、BOM付きUTF-8か、データタブの取り込みで文字コードを指定する
- 先頭がゼロの数字は、取り込み時に「文字列」を指定する
