CSV を JSON に変換する方法とは？核心となる考え方はただ一言です。カンマ区切りの行と列のデータを、ヘッダーに従ってキーと値のペアにマッピングすることです。最初のステップで先頭行がヘッダーであることを確認し、2 番目のステップで引用符と改行を処理し、3 番目のステップで変換方法を選びます。手書きのスクリプト、ローカルプログラム、またはブラウザで動作するオンラインツールです。以下ではこの順序で各ステップを詳しく説明します。
CSV を JSON に変換するとは
CSV を JSON に変換するとは何かは、まず 2 つの形式の違いから見ることができます。CSV はプレーンテキストの 2 次元表であり、各行が 1 つのレコードで、フィールドはカンマで区切られ、先頭行は通常列名です。JSON は波括弧と角括弧で階層を表現し、1 つのレコードは 1 つのオブジェクトで、フィールド名は引用符で囲まれます。
変換の本質は「列名 + その列の値」をキーと値のペアにすることです。たとえばヘッダーが name,age で、最初の行が Li,30 なら、変換結果は {"name": "Li", "age": 30} になります。
いくつか注意すべき落とし穴があります：
- CSV には型の概念がなく、
30と"30"はテキスト上では同じに見えるため、JSON に変換する際に数値やブール値を推論するかどうかを決める必要があります - 空のセルは空文字列、
nullに変換することも、そのキー自体を省略することもでき、3 つの方法はいずれも一般的です - フィールド自体にカンマが含まれる場合、CSV では二重引用符で囲む必要があり、パーサーはこの書き方を認識しなければなりません
CSV を JSON に変換するとは何かを理解すれば、どのフィールドをそのまま保持し、どのフィールドに型変換が必要かを判断できます。
CSV を JSON に変換する方法：段階的な操作
ステップ 1：ヘッダーとエンコーディングを確認する
ファイルを開き、最初の行がデータではなく列名であることを確認します。列名にはスペースや中国語の句読点を含めないでください。そうしないと、生成されたキー名は多くのプログラミング言語でアクセスするために追加の引用符が必要になります。エンコーディングは UTF-8 に統一し、中国語が文字化けするのを避けます。
ステップ 2：区切り文字と引用符のルールを確認する
デフォルトの区切り文字はカンマですが、エクスポートされたファイルではセミコロンやタブもよく見られます。フィールドの内容に区切り文字が含まれる場合、標準的な方法は二重引用符で囲み、フィールド内の二重引用符は連続する 2 つの二重引用符として書きます。
ステップ 3：変換方法を選ぶ
3 つの方法にはそれぞれ適した場面があります：
- 手書きスクリプト：フィールドのルールが固定され、繰り返し実行する必要がある場面に適しており、最も制御力が高いです
- ローカルプログラムや表計算ソフトのエクスポート：一度だけ処理する場合に適していますが、ソフトウェアの空値や型に対するデフォルトの扱いに注意が必要です
- ブラウザのオンラインツール：環境をインストールしたくない、ファイルが機密でない、または構造を素早く検証したい場面に適しており、オンラインツール一覧 を開けば選べます
ステップ 4：出力を検証する
変換後はまず 3 つのことを確認します：レコード数が元ファイルのデータ行数と一致しているか、カンマを含むフィールドが完全か、数値フィールドに誤って引用符が付いていないか。構造が正しくない場合はステップ 2 に戻って引用符のルールを確認します。
CSV を JSON に変換するインストール不要のオンラインツール
ローカルマシンに実行環境をインストールしたくない場合、CSV を JSON に変換するインストール不要のオンラインツールが最も手軽な方法です。この種のツールはブラウザ内で選択したファイルを直接読み取り、スクリプトで解析とシリアライズを完了し、サーバーに依存しません。
この種のツールを選ぶ際のポイント：
- 解析がローカルで完了するか、ファイルがアップロードされないか
- 区切り文字を指定できるか、カスタムヘッダーをサポートしているか
- 出力が配列か、行ごとに連結されたオブジェクトストリームか
- 空値と数値型の処理ルールが明確に書かれているか
能力の限界を説明しておく必要があります：ブラウザのローカル解析は利用可能なメモリに制限され、非常に大きなファイルは遅延したり中断したりする可能性があり、そのような場合はコマンドラインでの処理がより適しています。まず 当サイトのツールページ で既存ツールの処理方法を確認し、それから手持ちのファイルを開くのに使うかどうかを決めるとよいでしょう。
CSV を JSON に変換する際のエラーの解決方法
CSV を JSON に変換する際のエラーの解決方法は、多くの場合ツールの問題ではなく、ファイル自体が規格に準拠していないことが原因です。以下の順序で確認してください。
エラー：フィールド数がヘッダーと一致しない
ある行で解析されたフィールド数がヘッダーより多いか少ない状態です。よくある原因は、フィールド内にエスケープされていないカンマが含まれているか、行末に余分な区切り文字があることです。テキストエディタでエラー行番号に移動し、そのフィールドを二重引用符で囲んでください。
エラー：JSON の解析に失敗する、または出力が不正
通常はキー名の重複、またはフィールド値にエスケープされていない引用符やバックスラッシュが残っていることが原因です。エスケープのルールは：二重引用符は \"、バックスラッシュは \\、改行は \n と書きます。
エラー：中国語の文字化け
ソースファイルが UTF-8 でない可能性が高いです。エディタで UTF-8 として保存し直してからもう一度変換してください。ファイルが古いバージョンの表計算ソフト由来の場合、エクスポートされたものがローカルエンコーディングである可能性があります。
エラー：数値またはブール値の型が正しくない
CSV には型情報がないため、パーサーは推測するしかありません。変換時にフィールド型を明示的に指定するか、変換後にコードで一括して型変換を行うかのどちらかです。CSV を JSON に変換する際のエラーの解決方法といった問題に遭遇したら、まず形式の問題か型の問題かを確認してください。両者の修正方法はまったく異なります。
CSV を JSON に変換する際の大きなファイルの処理方法
CSV を JSON に変換する際の大きなファイルの処理方法の鍵はメモリにあります。一度にすべて読み込んでから全体をシリアライズすると、メモリ使用量はファイルサイズの数倍に相当し、数百メガバイト以上になると失敗しやすくなります。
実行可能な方法：
- ストリーミング処理で、行ごとに読み取り、レコードごとに出力し、配列全体をメモリ内に組み立てるのを避ける
- ファイルを分割し、行数に応じていくつかに切って個別に変換してから結合する
- コマンドラインツールとパイプを組み合わせてディスクに書き込み、ターミナルに出力しない
- 変換前に不要な列を削除してサイズを減らす
構造を確認したいだけなら、まず先頭の数百行を切り出して試し、フィールドのマッピングが正しいことを確認してから全体を実行すると、大量の再試行時間を節約できます。
CSV を JSON に変換することとオンライン表へのインポートの違い
CSV を JSON に変換することとオンライン表へのインポートの違いは、成果物と用途にあります。CSV を JSON に変換すると構造化テキストが生成され、バージョン管理に直接入れられ、API に入れられ、プログラムから読み取ることができます。オンライン表へのインポートはデータを表計算アプリに入れ、行と列のビューや数式を保持し、成果物は依然として表です。
判断方法は簡単です：その後コードでこのデータを消費するなら JSON に変換し、その後人間が確認、フィルタリング、グラフ作成をするなら表に残します。両者は衝突しません。多くのフローでは、まず JSON に変換してプログラムに入れ、その後別途表として保存して人に見せます。
よくある質問
CSV を JSON に変換するのにネット接続は必要ですか
必ずしも必要ではありません。ブラウザでローカルに動作するツールやローカルスクリプトを使えば、全体を通してネット接続は不要で、ファイルがデバイスから離れることもありません。サーバー側で変換するサービスのみファイルのアップロードが必要で、機密データはそのような方法を避けることをお勧めします。
先頭行がヘッダーでない場合はどうすればよいですか
手動で列名の行を追加するか、ツールで何行目からヘッダーとして開始するかを指定します。ヘッダーのない CSV は配列形式しか生成できず、キー名を別途指定する必要があり、そうしないと出力にフィールド名が欠けます。
出力は配列とオブジェクトのどちらにすべきですか
レコードの集合には配列を使い、各行が 1 つのオブジェクトになります。これが最も一般的な形式です。各行に一意の主キーがある場合は、主キーをキーとするオブジェクトとして出力することもでき、ID で直接値を取得するのに便利です。どちらを選ぶかは下流でどう読むかによります。
空のセルはどう処理しますか
3 つの方法があります：空文字列に変換する、null に変換する、そのキーを省略する。最初の 2 つはフィールドの位置を保持し、3 番目はオブジェクトをよりきれいにしますが、異なるレコード間でフィールドが不一致になります。チーム内で 1 つのルールに統一すればよいです。
変換された JSON の順序は変わりますか
キーの順序はほとんどの実装で挿入順に保持されますが、それに依存することはお勧めしません。プログラムが読み取る際はキー名で値を取得するため、順序は結果に影響しません。固定の順序が必要な場合は生成後に別途並べ替えてください。
まとめ
CSV を JSON に変換する方法は、操作に落とし込むと、ヘッダーを確認し、引用符とエンコーディングを処理し、変換方法を 1 つ選び、出力を検証するということになります。形式の問題はまず引用符と区切り文字を確認し、メモリの問題はまずストリーミング処理を検討します。これらのステップをフローとして固定すれば、その後 CSV を JSON に変換する際のエラーの解決方法や、CSV を JSON に変換する際の大きなファイルの処理方法といった状況に遭遇しても、同じ順序で特定できます。