CSV を JSON に変換する

TL;DR

CSV/JSON Converter はブラウザ内で完全に動作します。データはローカルで解析・変換されます — アップロードもサーバー側の処理もありません。CSV to JSON と JSON to CSV の方向を切り替え、区切り文字を選び、ヘッダーの扱いを設定し、結果をコピーまたはダウンロードする前に、行と列のサマリーを確認できます。

このツールは両方向の変換を扱い、指定すれば区切り文字を自動検出し、（不揃いの行など）の問題を、データを黙って捨てるのではなく警告として報告します。

ブラウザ内で変換する理由

CSV はデータエクスポートの共通語です — スプレッドシート、データベース、API はすべて CSV を出力します — が、アプリケーションコードが欲しいのはほぼ常に JSON です。ブラウザ内で変換するということは、機密性のある行（顧客リスト、財務エクスポート、ログ）が第三者のサーバーに触れないことを意味します。また、即座のフィードバックも得られます。区切り文字を変えたりヘッダーを切り替えたりすると出力がすぐに更新され、コミットする前に確認できるプレビューが表示されます。

CSV を JSON に変換する

1. CSV/JSON Converter を開き、CSV to JSON モードを選択します。
2. ソース領域に CSV を貼り付けます。
3. Delimiter を選びます：Auto（既定、セパレータを検出）、Comma、Semicolon、Tab、Pipe。エクスポートがカンマ区切りかセミコロン区切りか分からないときは Auto が便利です。
4. 出力を形作る CSV オプションを設定します：
   • Header — 最初の行をフィールド名として扱い、JSON が配列のインデックスではなくオブジェクトキーを使うようにします。
   • Dynamic typing — 数値や真偽値に見える値を、文字列のままではなく本物の数値や真偽値に変換します。
   • Skip empty lines — 空のレコードを出力する代わりに、空行を無視します。
   • Trim headers — よりきれいなオブジェクトキーのために、ヘッダー名の前後の空白を取り除きます。
   • JSON Lines — 単一の JSON 配列ではなく、1行に1つの JSON オブジェクトを出力します（NDJSON）。
   • Minify — インデントを省き、コンパクトな出力を生成します。
5. 変換をクリックし、summary（行数、列数、検出された区切り文字、出力サイズ）と preview を読みます。

ヘッダーオプションがオンのときは、各行がヘッダー名をキーとするオブジェクトになります。オフのときは、各行が値の配列になります。不揃いの行やその他の構造上の問題は、変換全体を失敗させるのではなく、問題リストに警告として表示されます。

JSON を CSV に変換する

1. JSON to CSV モードに切り替えます。
2. JSON を貼り付けます。ソースはフラットなオブジェクトの配列（またはコンバータがフラット化できる値）である必要があります — 深くネストした形状や非表形式の形状は、黙って強制されるのではなく、未対応として報告されます。
3. Delimiter を選びます：Comma、Semicolon、Tab、Pipe。自動検出は CSV 入力の機能なので、CSV を生成するときは提供されません。
4. JSON オプションを設定します：
   • Header — オブジェクトのキーから最初の行としてヘッダー行を書き出します。
   • Minify — 余分なスペースなしのコンパクトな CSV を生成します。
5. 変換し、サマリーとプレビューを確認します。

コンバータはヘッダーのためにすべてのオブジェクトのキーの和集合を集め、オブジェクトごとに1行を書き出します。無効な JSON はキャッチされ、中途半端なファイルができる代わりに明確なメッセージで報告されます。

ファイルを扱う

データを直接貼り付けることも、ファイルを読み込むこともできます。ツールは読み込む前にファイルを検証します。未対応のファイル種別や大きすぎるファイルは、部分解析の後ではなく、直ちに (unsupportedFile または fileTooLarge として) 明示的なメッセージで前もって拒否されます。完了したら、ダウンロードアクションで、現在の方向に応じた igottools-csv-json-converter.json（または .csv）という名前のファイルが生成されます。

サマリーとプレビューを読む

成功した変換はすべて、出力とともに summary と preview を返します：

• Summary — 総行数、総列数、実際に使われた区切り文字、エラー数、出力サイズ（バイト）。
• Preview — 検出されたヘッダーと変換された行のサンプルで、コピーまたはダウンロードする前に構造を確認できます。
• Issues — 変換が注意事項付きで成功した場合（例えば不揃いの行や強制された値）、行番号付きの警告のリストとして表示されます。純粋な成功には問題はありません。致命的な失敗は、message キーを含む無効な結果を返します。

正直な限界と注意点

• フラットなデータが最適。 コンバータは表形式のデータ、つまりフラットなレコードの配列向けに作られています。深くネストした JSON や不均一なオブジェクトは、ヒューリスティックにフラット化されるのではなく、未対応の形状として報告されることがあります。
• 自動検出は CSV 入力のみ。 CSV を生成するときは具体的な区切り文字を選ぶ必要があります。その方向では Auto は使えません。
• ファイルサイズには上限があります。 大きすぎるファイルは解析前に拒否されます。非常に大きなデータセットでは、入力を分割するか、専用のオフラインパイプラインを使ってください。
• 動的型付けはオプトインです。 既定では値は文字列のままで、ソースにあったものを正確に確認できます。データが一貫して数値や真偽値であると信頼できる場合にのみ動的型付けをオンにしてください。
• 保存なし。 コンバータは入力も出力も記憶しません。ページを再読み込みすればすべて消去されます — 機密データにとっては安全な既定値です。

関連ツール

• JSON Formatter — 生成した JSON を整形・検証・探索します。/ja/tools/dev/json-formatter/ を参照してください。
• JSONPath Tester — 変換された JSON を JSONPath 式でクエリし、必要な行を取り出します。/ja/tools/dev/jsonpath-tester/ を参照してください。
• JSON to TypeScript — 変換された JSON からアプリケーションコード用の TypeScript 型を生成します。/ja/tools/dev/json-to-typescript/ を参照してください。

FAQ

データはどこかにアップロードされますか？

いいえ。変換はブラウザ内で完全に実行されます。CSV、JSON、読み込んだファイルはすべてローカルで解析・変換され、サーバーに送信されることはありません。

どの区切り文字が使えますか？

CSV 入力の場合：Auto、Comma、Semicolon、Tab、Pipe。JSON から CSV への出力の場合：Comma、Semicolon、Tab、Pipe（CSV を生成するときは自動検出は提供されません）。

Header オプションは何をしますか？

CSV to JSON では最初の行をフィールド名として扱い、各レコードが配列ではなくそれらの名前をキーとするオブジェクトになります。JSON to CSV では、オブジェクトのキーを出力の最初の行として書き出します。

不揃いや不正な入力ではどうなりますか？

致命的な失敗（空の入力、無効な JSON、未対応の形状）は明確な無効な結果を返します。不揃いの行のような回復可能な問題は、行番号付きの警告リストとともに成功した変換を生成するので、残りのデータを失うことなく何が調整されたかを確認できます。

JSON Lines（NDJSON）出力は得られますか？

はい。CSV to JSON モードで JSON Lines をオンにすると、単一の JSON 配列ではなく、1行に1つの JSON オブジェクトを出力します — ストリーミングパーサーやログ風パイプラインに便利です。