JSONからCSVへの変換ツール

列の並び順の戦略

• 最初のレコードから：列は最初のJSONオブジェクトのキーと一致します。高速で決定的です。後続のレコードにのみ現れるキーは見落とされます。
• すべてのキーの結合：すべてのレコードをスキャンし、すべてのキーを収集します。非常に大規模なデータセットでは処理が遅くなりますが、完全な列の一覧を生成します。
• カスタム順序：カンマ区切りの列名リストを指定します。それ以外はすべて、出現した順に末尾へ追加されます。

引用符とエスケープ

RFC 4180に準拠しています：

• カンマ、改行、またはダブルクォートを含むフィールドは、ダブルクォートで囲む必要があります。
• 引用フィールド内のダブルクォートは、二重にすることでエスケープします。例えば He said "Hi" は "He said ""Hi""" になります。
• 引用フィールド内の改行は有効ですが、すべてのインポーターが処理できるわけではありません。最大限の互換性が必要な場合は「改行をエスケープする」をオンにしてください。

データ型の保持

CSVはテキストであり、すべてが文字列です。数値列、ブール値、日付といった型のヒントは、読み込む側のパース処理に依存します。いくつかのコツを紹介します：

• 先頭のゼロ（007）はCSV内では文字列として保持されますが、Excelは何も告げずに数値へ変換します。=""007"" を接頭辞として付ける（見栄えは悪いですが機能します）か、Excelでテキストとしてインポートしてください。
• 2^53 を超える大きな整数はExcelで精度が失われます。JSON内では文字列として保持してください。
• ISO日付（2026-04-18T10:22:00Z）は、インポート時に列がテキストとして書式設定されている場合にのみ、Excelでのやり取りを経ても保持されます。
• ブール値は true / false の文字列になります。後続の処理が 1/0 を期待する場合は、エクスポート前にマッピングしてください。

BOMとExcel

Windows版Excelでは、ファイルの先頭にUTF-8のBOM（0xEF 0xBB 0xBF）が必要です。ないと、UTF-8バイトをLatin-1として解釈し、ASCII以外の文字がすべて文字化けします。Mac版のNumbersとGoogle Sheetsはどちらにも対応しています。

よくある間違い

• 配列ではなくオブジェクトを渡す。 このツールには {...} ではなく [{...}, {...}] が必要です。まずアンラップしてください。
• レコードごとに異なるキー。 列の欠落を防ぐには「すべてのキーの結合」戦略を使ってください。
• null用のセンチネル値。 一部のパイプラインは空のセルをnullとして扱い、別のパイプラインは文字列 "" として扱います。1つの規約を選び、プロジェクト全体で一貫させてください。
• ロケールの不一致。 , でエクスポートしたデータを、; を期待する欧州版Excelで開くと列が崩れることがあります。区切り文字を対象ロケールに合わせてください。