An extension optimized for viewing and editing massive CSV files containing large nested JSON cell values.
Features
- Optimized for gigabyte-scale CSV datasets (up to 10GB+).
- Byte offset indexing ensures extremely low memory footprint (under 100MB).
- Lazy loads massive cell values into Monaco Editor to prevent Webview crash.
- Compliance with RFC 4180 for quotation and newline escaping.
使い方 (Usage)
本拡張機能は、巨大なCSVファイル（ギガバイト規模）や、セル内に非常に大きなJSONオブジェクトが含まれるファイルを、VS Code（リモート環境を含む）で高速かつ安全に編集するためのツールです。
1. インストール方法 (Installation)
ビルド済みの VSIX ファイル（csv-json-editor-extension-1.0.0.vsix）からインストールを行います。
方法 A: VS Code UI からインストール
- VS Code を起動します。
- 拡張機能ビュー（
Ctrl+Shift+X/Cmd+Shift+X）を開きます。 - 右上の
...（More Actions）メニューをクリックし、「VSIX からのインストール... (Install from VSIX...)」 を選択します。 - ビルドされた
csv-json-editor-extension-1.0.0.vsixファイルを選択してインストールします。
方法 B: コマンドラインからインストール
ターミナルで以下のコマンドを実行します。
code --install-extension csv-json-editor-extension-1.0.0.vsix
2. 起動方法 (How to Open)
- VS Code のエクスプローラー上で、開きたい大容量の CSV ファイルを右クリックします。
- 「プログラムから開く... (Open With...)」 を選択します。
- リストから 「Large CSV JSON Editor」 を選択します。
[!NOTE] 初回読み込み時はインデックスファイル（
.idx）がCSVファイルと同じディレクトリに自動生成されます。これにより、次回以降の起動やスクロールが高速化されます。
3. 操作方法 (Operations)
A. データの閲覧と仮想スクロール
- 読み込みが完了すると、CSV データがグリッド形式で表示されます。
- ギガバイト規模のファイルであっても、表示領域のみを描画する仮想スクロールが適用されているため、軽快にスクロールできます。
- セル内に巨大な JSON が含まれている場合、グリッド上には先頭の一部テキストのみがプレビュー（要約表示）されます。これにより、ブラウザ（Webview）のメモリクラッシュを回避します。
B. セル（巨大JSON）の編集
- 編集したいセルをダブルクリックします。
- 画面右側に JSON Editor（Monaco Editor）が表示され、該当セルの詳細な JSON データが遅延ロードされます。
- シンタックスハイライトやインデント整形機能を利用しながら、JSON データを編集します。
- 編集が完了したら、エディタ上部の 「変更を適用 (Apply Change)」 ボタンをクリックしてグリッドデータを更新します。
C. データの保存
- 編集したデータをファイルに保存するには、画面上部（またはエディタフッター）の 「変更を保存 (Save File)」 ボタンをクリックします。
- データの書き出しはストリーム方式で行われるため、大容量ファイルであっても VS Code プロセスのメモリ上限に達することなく、安全に保存されます。
- ダブルクォーテーションや改行などのエスケープ処理は、RFC 4180 に完全に準拠して行われます。