ぱんだふるツール のマスコットぱんだふるツールやりたいことが、すぐできる。
開発・IT

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

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を直接ダブルクリックで開くと、日本語が化けることがあります。対処は次のとおりです。

  1. BOM付きUTF-8で保存する: ファイルの先頭に目印(BOM)を付けると、ExcelがUTF-8だと判別できます。テキストエディタの「UTF-8 (BOM付き)」で保存し直せます。
  2. 取り込み機能を使う: Excelの「データ」タブから「テキストまたはCSVから」を選び、文字コードに UTF-8 を指定して読み込みます。
  3. Shift_JISで書き出す: 相手がExcelだけなら選べますが、一部の特殊な漢字や記号が変換できないことがあります。

新しいバージョンのExcelではUTF-8のCSVをそのまま開けることもありますが、環境によって違います。化けたら上の方法を試してください。

ブラウザで手軽に変換する

コードを書くほどでもない、1回だけ変換したい、というときはJSON ↔ CSV 変換ツールが便利です。JSONを貼り付けるとCSVに、CSVを貼り付けるとJSONに変換できます。ブラウザの中だけで動くので、手元のデータを気軽に試せます。

変換前にJSONの書き方が正しいか確認したいときは、JSON整形で検証してから使うと安心です。エラーがあれば場所のヒントも出ます。

まとめ

  • JSON → CSVは「同じ形のオブジェクトの配列」がいちばん簡単
  • 入れ子は、平らにするか1セルにまとめるかを先に決める
  • カンマ・改行・引用符を含む値はダブルクォートで囲む
  • Excelで化けたら、BOM付きUTF-8か、データタブの取り込みで文字コードを指定する
  • 先頭がゼロの数字は、取り込み時に「文字列」を指定する

この記事で使うツール

🧩 JSON ↔ CSV 変換 →

JSONとCSVを相互変換。