JSON CSV へ 変換ツール

JSON と CSV は目的がまったく異なる 2 種類の data format です：

• JSONJSON（JavaScript Object Notation）は、ネストしたオブジェクトや配列を扱える構造化データ形式で、プログラム間のデータ交換や API 通信に適しています。
• CSVCSV（Comma-Separated Values）はプレーンテキストの表形式です。各行が 1 record、各列が 1 field を表し、Excel、Google Sheets、database の import/export で広く使われます。

JSON から CSV への変換は、次のような場面に適しています。

• API データを Excel や Google Sheets に取り込み、分析したい場合に利用できます。
• machine learning や statistical analysis 用の dataset を準備します。
• 非技術者と structured data を共有する用途（CSV なら Excel で直接開けます）。
• database へのデータ取り込み（MySQL と PostgreSQL は CSV import に対応）
• 意思決定者の確認用にレポートやスプレッドシートを作成

CSV は 2 次元 table format（row × column）で、nested structure を直接表せません。このツールを使って ドット記法でフラット化 ネストされたオブジェクトをフラットなフィールドへ自動変換する技術。

{
  "user": {
    "name": "Gary",
    "age": 30
  }
}

user.name,user.age
Gary,30

フラット化ルール：

• object → 再帰的にフラット化し、Key をドットで連結します。例: profile.address.city
• 配列 → field の増殖を避けるため、1セル内に JSON string として保存します。
• Null → null value の設定に従って処理されます（empty string / null / N/A / 0）。

フラット化が行われた場合、ツール上部にオレンジ色で「Nested JSON has been automatically flattened.」と表示されます。

CSV を Excel へ import する方法はいくつかあります。

1. 直接開く： .csv ファイルをダウンロードしたら、Excel で直接開いてください（UTF-8 エンコーディングを選択）。
2. データからインポート： Excel → Data → Import from text/CSV → ファイル選択 → 区切り文字と Encoding を指定
3. Google Sheets へドラッグ： .csv ファイルを Google Sheets へドラッグするだけで自動的に解析できます

UTF-8 BOM とは何ですか？

BOM（Byte Order Mark）はファイルの先頭に配置されます  マーク。CSV ファイルの場合：

• BOM を有効化 → Excel が UTF-8 を自動認識し、中国語、日本語、その他の Unicode 文字を正しく表示します。
• BOM なし → Excel がシステム既定 encoding（Big5 など）で開き、文字化けする場合があります。

💡 CSV を Excel へ読み込んだ後に中国語が文字化けする場合は、「UTF-8 BOM」を有効にして再度ダウンロードしてください。

CSV の C は Comma を意味しますが、実際には CSV で別の delimiter を使うこともできます。

• カンマ（,） — 最も一般的な標準で、Excel と Google Sheets の既定形式でもあります。ただしデータにカンマが含まれる場合（例: 住所「Taipei City, Taiwan」）は quotation marks で囲む必要があります。
• セミコロン（;） — 一部の欧州地域では小数点にコンマを使うため、Excel の既定区切り文字がセミコロンになっています。CSV が Excel で正しく列に分かれない場合は、セミコロンを試してください。
• Tab（\t） — TSV（Tab-Separated Values）とも呼ばれます。データ内にコンマやセミコロンが頻繁に含まれる場合、Tab は安全な選択肢です。多くのデータベース取り込みツールでも TSV が優先的に扱われます。

💡 どれを使うか迷った場合は、まず comma を試してください。Excel で正しく表示されない場合は semicolon に切り替えてみてください。

よくある問題と解決方法は次のとおりです：

• ネストされたオブジェクトデータがありませんか？ このツールは nested JSON を自動的に flatten します（例： profile.age), ただし JSON structure が複雑すぎる場合（5 level を超える deep nesting など）は、変換前に data を簡略化することを推奨します。
• 配列データが切り詰められていますか？ 配列フィールドは JSON 文字列として 1 つのセルに保持されます（例： "["a","b","c"]")、Excel へ import しても自動展開されない場合があります。その場合は Excel の「データ → テーブル/範囲から」で追加処理できます。
• 中国語文字が文字化けするのはなぜですか？ 「UTF-8 BOM」option を有効にして再 download すると、Excel が UTF-8 encoding を正しく認識できます。
• CSV が Excel で 1 列にまとめて表示される場合は？ Use "semicolon (;)" or "Tab (\t)" as the delimiter instead, or manually specify the delimiter when importing into Excel.

100% 安全です。 このツールは純粋なフロントエンド（Client-side）構成で、JSON の解析と CSV 変換はすべてブラウザ内で完結します。データがサーバーへアップロードされることはありません。

つまり：

• customer data、API response、trade secret が端末外へ送信されることはありません。
• 変換処理そのものに internet connection は不要です。初回の page load 時を除き、offline でも実行できます。
• バックエンドサーバーが内容を保存・処理することはありません
• 入力したデータには ToolHub の管理者でさえアクセスできません

顧客 list、財務 data、機密 API response の変換など、さまざまなデータ処理をブラウザ内で安全に行えます。