CSV → JSON 変換ツール — オンラインで CSV を JSON へ解析 _

CSV → JSON 変換とは何ですか？

CSV（カンマ区切り値、RFC 4180）はフラットな表形式のテキスト形式で、JSON（JavaScript Object Notation、RFC 8259）は構造化データのための木構造のテキスト形式です。CSV を JSON に変換することで、表計算向きの表を API 向きのオブジェクト配列へ変換できます — 1 行が 1 オブジェクト、ヘッダー行がキーを提供し、セルの打ち直しは一切不要です。

CSV → JSON 変換はどのように動作しますか？

すべての変換はブラウザー内でローカルに実行されます。大まかな手順は次のとおりです：

1. CSV を入力ペインに貼り付けて「変換」を押すと、ツールがテキストを解析し、JSON オブジェクトの配列を出力ペインに表示します。
2. 文字単位の状態機（FIELD_START → IN_UNQUOTED_FIELD または IN_QUOTED_FIELD）が入力を走査し、"" による引用符エスケープを尊重し、\r\n と \n の両方を行終端として認識して、中間表現として 2 次元の文字列配列を生成します。
3. 先頭行がヘッダーとして指定されている場合、そのセルがオブジェクトキーになります。そうでない場合、ツールは合成キー field0、field1、… を生成し、すべての行が完全なオブジェクトにマッピングされます。
4. 区切り文字（カンマ、セミコロン、タブ、パイプ、または自動判定）と型推論（数値 / 真偽値 / null）はすべて設定可能です。型推論が有効なら 30 は数値 30 に、true は真偽値になります。無効なら各セルは文字列のままです。
5. 出力は JSON.stringify 形式のテキストとして読み取り専用テキストエリアに書き込まれ、ダウンロードリンクは MIME タイプ application/json;charset=utf-8 の Blob として生成されるため、ワンクリックで保存できます。

このツールで CSV を JSON に変換する理由は？

• プライバシー：解析・変換のすべてがブラウザー内で行われます。データが当社のサーバーに届くことはありません。
• 正確さ：CSV パーサーは正真正銘の状態機です。引用符付きのカンマ（"Bob, Jr."）、埋め込み改行、エスケープされた引用符を含むフィールドは 3 セルではなく 1 セルとして解析されます — 素朴な split(',') 実装ではここで誤ります。
• 型の忠実さ：オプションの型推論により、数値セルや真偽値セルが本物の JSON 数値・真偽値に変換されるため、得られた配列は二次クリーンアップなしにそのまま利用できます。
• 柔軟性：非カンマ系の CSV 方言にも任意の区切り文字を選べ、先頭行をヘッダーとするか選択でき、すべてのセルを文字列のまま保ちたい場合は型推論を切れます。

CSV → JSON 変換の一般的な用途は何ですか？

CSV を JSON へ解析する作業は、データ業務やツールづくりのあちこちで登場します：

• API モック：表計算ソフトから書き出した CSV フィクスチャを貼り付け、それを JSON 配列に変換してローカルサーバーがモックエンドポイントとして返せるようにする。
• データのインポート：スプレッドシートのエクスポート（連絡先、在庫、アンケート結果）を、CSV パーサー依存なしにアプリやスクリプトが反復できる JSON 配列に変換する。
• 設定ファイルの編集：設定値や機能フラグを非技術レビューアがスプレッドシートでセル単位に編集し、保存した CSV をアプリが実際に読み込む JSON へ変換する。

CSV → JSON の変換例はどんな見た目ですか？

1 行目に name,age、2 行目に Alice,30、3 行目に "Bob, Jr.",25 を貼り付け、カンマ区切り・先頭行をキー・型推論オンで「変換」を押すと [{"name":"Alice","age":30},{"name":"Bob, Jr.","age":25}] が得られます。"Bob, Jr." の引用付きカンマは 1 フィールド内に収まり、年齢は本物の JSON 数値になります。

この CSV → JSON 変換ツールは完全にブラウザー内で動作しますか？

はい。解析・変換のすべてが、ブラウザータブの中の JavaScript としてローカルに実行されます。本ツールは fetch、XMLHttpRequest、navigator.sendBeacon をまったく呼び出しません — あなたの CSV ペイロードは、当社のサーバー、サードパーティの変換サービス、解析パイプラインのいずれにも届きません。ページを一度読み込んでしまえばオフラインでも動作します。これは実行時の API 依存を持たない静的な HTML/CSS/JS バンドルだからです。

この変換ツールが扱える入力サイズの上限はどれくらいですか？

変換ツールは入力全体をメモリーにバッファし、メインスレッドで同期的に実行するため、実際の上限はお使いの端末性能に依存します。最近のノート PC であれば、約 10 MB の CSV（およそ 10 万件の典型的なレコード）は目立った遅延なく変換できます。それを超えると UI が固まる可能性があります。Web Worker とチャンク式パーサーによるストリーミング変換は今後の予定です — それまでは、非常に大きなデータセットは事前に分割してから貼り付けてください。

CSV → JSON のパーサーは引用付きカンマや埋め込み改行をどう扱いますか？

パーサーは 3 状態（FIELD_START、IN_UNQUOTED_FIELD、IN_QUOTED_FIELD）を持つ文字単位の状態機であり、素朴な split(',') ではありません。二重引用符で囲まれたフィールドは、区切り文字、CR、LF、あるいは "" としてエスケープされたリテラル二重引用符を、フィールド境界を壊さずに含むことができます。したがって "Bob, Jr.",25 は 3 フィールドではなく 2 フィールドに解析され、行をまたいで引用された複数行の説明も 1 セルとして解析されます。

数値、真偽値、空セルは JSON 出力でどのように型付けされますか？

型付けは 型推論 トグルが制御します。推論オン（既定）の場合、数値に見えるセルは JSON 数値に、true/false は真偽値に、リテラル null は JSON null になり、それ以外は文字列のまま保たれます。推論オフの場合、内容に関わらずすべての値が文字列として保持されます — 先頭ゼロ、電話番号、ID コードを変換せずに残す必要がある場合に有用です。短い行の末尾に欠落したセルは空文字列として出力され、すべてのオブジェクトが完全なキーセットを持つようにします。

CSV 側で対応している区切り文字は何ですか？

明示的に 4 種の区切り文字に対応します：カンマ（,、RFC 4180 の既定）、セミコロン（;、欧州ロケールで一般的）、タブ（\t、TSV 方言）、パイプ（|）。自動判定 も選べます。これは入力の先頭 4 KB について引用領域外での各候補の出現数を数え、先頭 5 行で列数が安定する中で最も頻出するものを選びます。

この CSV → JSON 変換ツールは、本物の状態機で解析し、そのまま API 呼び出し、スクリプト、コードレビューに貼り付けられる整形済みの JSON を生成します — 1 バイトもアップロードせずに。