CSVとJSONを相互変換する方法：API連携・データ移行での使い分け

表形式のCSVと構造化データのJSONを安全に変換するための考え方、ヘッダー行、区切り文字、型の扱い、実務での注意点を解説します。

この記事に関連するツール

ブラウザ上ですぐに試せます。記事の内容を確認しながら使うと、作業の流れをつかみやすくなります。

CSVとJSONの変換イメージ

CSVは表計算ソフトや一括インポートで扱いやすい、シンプルな表形式です。
一方でJSONは、APIレスポンスや設定データのように、オブジェクトや配列を含む構造化データを表現しやすい形式です。

この2つを相互変換できると、非エンジニアとのデータ受け渡し、管理画面への一括登録、APIのテストデータ作成がかなり楽になります。

多くのCSVでは、1行目に name,email,role のようなヘッダーがあります。
JSONへ変換するときは、このヘッダーをオブジェクトのキーとして使うと扱いやすくなります。

[
  { "name": "Alice", "email": "alice@example.com", "role": "admin" }
]

CSVと呼ばれていても、実際にはカンマではなくタブやセミコロンで区切られていることがあります。
うまく列に分かれない場合は、区切り文字の設定を見直しましょう。

CSVではすべての値が文字列として見えます。
JSONに変換したあと、ID、郵便番号、電話番号のように「数字に見えるが文字列として扱うべき値」がないか確認しておくと安全です。

JSONをCSVにする場合は、1つの配列に同じ形のオブジェクトが並んでいると変換しやすくなります。
ただし、ネストしたオブジェクトや配列は、そのまま表の1セルに入りきらないことがあります。

たとえば profile.name のようにキーをフラット化するか、必要な項目だけに絞ってCSV化するのが実務では扱いやすいです。

CSV ⇔ JSON変換ツールを使うと、CSVからJSON、JSONからCSVの両方向に変換できます。
区切り文字やヘッダー行の有無を切り替えられるので、Excel、スプレッドシート、APIレスポンスの間を行き来しやすくなります。

変換後のJSONをさらに確認したい場合は、JSON整形ツールで構造を読みやすく整えられます。
設定ファイルとして扱いたい場合は、JSON ⇔ YAML変換ツールへつなげるのも便利です。