JSONとCSVの違いとは？初心者でもわかる特徴・使い分け・IT現場での利用例を解説

結論として、JSON（JavaScript Object Notation）はシステム同士でデータをやり取りするためのデータ形式、CSV（Comma-Separated Values）は表形式のデータを保存・交換するためのファイル形式です。

どちらもデータを扱うための形式ですが、用途は大きく異なります。JSONはAPIやWebサービスでよく利用され、CSVはExcelや業務システム間のデータのインポート・エクスポートで広く使われています。

JSONとは

JSONとはJavaScript Object Notationの略で、データを「項目名（キー）」と「値（バリュー）」の組み合わせで表現するデータ形式です。

人が読みやすく、プログラムでも扱いやすいため、REST APIやクラウドサービスなどで標準的に利用されています。

例えば、社員情報であれば「社員番号」「氏名」「部署」「メールアドレス」などを1つのデータとしてまとめて表現できます。

CSVとは

CSVとはComma-Separated Valuesの略で、データをカンマ（,）で区切って保存するファイル形式です。

Excelで開いて編集できるため、業務システムでのデータ移行や一括登録、バックアップなどによく利用されています。

CSVは表（テーブル）のような構造を持つシンプルな形式です。

JSONとCSVの違い

イメージすると理解しやすい例

JSONは社員一人ひとりのプロフィールカードのようなイメージです。

1人の社員に対して、氏名、部署、電話番号、住所など複数の情報をまとめて管理できます。

CSVは社員一覧表のようなイメージです。

行が社員、列が項目となり、多くのデータを一覧で確認できます。

JSONがよく使われる場面

• REST API
• Webサービス
• スマートフォンアプリ
• クラウドサービス
• システム間のデータ連携

現在のWebシステムではJSONが標準的なデータ形式です。

CSVがよく使われる場面

• Excelでのデータ編集
• 社員情報の一括登録
• 売上データの出力
• 商品マスターの登録
• システム移行
• データバックアップ

JSONが選ばれる理由

• 階層構造を表現できる
• APIとの相性が良い
• データの意味が分かりやすい
• プログラムで扱いやすい
• 複雑なデータにも対応できる

CSVが選ばれる理由

• Excelで開ける
• データ編集が簡単
• 多くのシステムで対応している
• ファイルサイズが小さい
• 一括登録や一括更新に向いている

IT現場での利用例

• APIからJSON形式で社員情報を取得する
• CSVで社員マスターを一括登録する
• 売上データをCSVで出力してExcelで集計する
• クラウドサービスからJSONを受信する
• システム移行時にCSVでデータを受け渡す

JSONとCSVは競合するものではなく、用途に応じて使い分けられています。

初心者が混乱しやすいポイント

• JSONとCSVはどちらもデータ形式だが用途が違う
• CSVはAPIの通信にはあまり使われない
• JSONはExcelで直接編集する用途には向かない
• CSVは階層構造を表現できない
• JSONは項目名を持つため意味が分かりやすい

業務でよくあるトラブル例

ケース1：CSVを取り込めない

原因例

• 列の順番が違う
• 項目数が一致しない
• 文字コードが異なる

ケース2：JSONを読み込めない

原因例

• 構文エラー
• 項目名の誤り
• API仕様変更

ケース3：文字化けする

原因例

• UTF-8とShift_JISの違い
• Excelの保存形式
• システム側の文字コード設定

確認する順番

1. JSONかCSVか確認する
2. システム仕様を確認する
3. 文字コードを確認する
4. データ形式が正しいか確認する
5. エラーログを確認する
6. サンプルデータと比較する

影響範囲の考え方

原因の切り分け

ログの確認方法

• アプリケーションログ
• APIログ
• インポートログ
• エラーログ
• システムログ

エラーメッセージや処理対象の行番号を確認すると、原因を特定しやすくなります。

イベントビューアーで確認する場合

Windows ServerでCSVの取り込みツールやAPIが動作している場合は、イベントビューアーでエラーを確認できます。

1. Windowsキーを押す
2. 「イベントビューアー」を開く
3. 「Windowsログ」を選択する
4. 「アプリケーション」または「システム」を確認する
5. エラーや警告の内容を確認する

コマンドプロンプトで確認できること

• type（CSV内容の確認）
• find（文字列検索）
• fc（ファイル比較）
• chcp（文字コード確認）

PowerShellで確認できること

• Import-Csv（CSVの読み込み確認）
• ConvertFrom-Json（JSONの解析確認）
• Get-Content（ファイル内容確認）
• Test-Path（ファイル存在確認）

初心者がやりがちなミス

• CSVをExcel形式（.xlsx）と同じだと思う
• JSONをExcelで編集しようとする
• 文字コードを確認しない
• CSVの列順を変更してしまう
• JSONの項目名を勝手に変更する

筆者の現場経験

社内SEとして社員情報の一括登録を担当した際、CSVの列順が1列ずれていたため、社員番号と氏名が入れ替わって取り込まれたことがありました。

また、API連携ではJSONの項目名が仕様書と異なっていたため、データを取得できなかったこともあります。

どちらもファイルやデータ形式を確認すれば防げるトラブルだったため、まずは仕様書やサンプルデータと比較することの重要性を実感しました。

上司へ報告するポイント

• JSONかCSVのどちらで問題が発生しているか
• 発生時刻
• 対象ファイル名
• エラーメッセージ
• 確認した内容
• 影響を受けるデータ件数

エスカレーションするタイミング

• 大量データの取り込みに失敗した
• データ破損の可能性がある
• システム仕様と一致しているのにエラーになる
• 複数システムへ影響している
• 原因を特定できない

関連するIT用語

• REST API
• XML（Extensible Markup Language）
• API（Application Programming Interface）
• UTF-8
• Shift_JIS
• Excel
• インポート
• エクスポート
• データマッピング
• 文字コード

よくある質問（FAQ）

JSONとCSVはどちらが優れていますか？

用途によって異なります。APIやシステム連携にはJSON、一括登録やExcelでの編集にはCSVが適しています。

CSVはExcelファイルと同じですか？

いいえ。CSVはテキストファイルの一種で、データをカンマ区切りで保存します。一方、Excelファイル（.xlsx）は書式や数式なども保存できる専用形式です。

JSONはExcelで開けますか？

開くことはできますが、表形式で見やすく編集する用途には向いていません。JSONはプログラムによる処理やAPIでのデータ交換を目的とした形式です。

まとめ

JSONはシステム同士がデータをやり取りするためのデータ形式、CSVは表形式のデータを保存・交換するためのファイル形式です。

REST APIやクラウドサービスではJSONが主流ですが、社員情報や商品マスターの一括登録、売上データの出力などではCSVが広く利用されています。

IT業務では「APIならJSON」「Excelで編集・一括登録ならCSV」という基本的な使い分けを理解しておくことで、システム連携やデータ移行、障害対応をスムーズに進められるようになります。