JSONLとは？JSON Lines形式の完全ガイド

JSONL構文ルール

JSONL形式はいくつかのシンプルなルールに従います：

• 各行は有効なJSON値（オブジェクト、配列、文字列、数値、ブール値、またはnull）でなければなりません
• 行は改行文字（\n）で区切られます
• 行間にカンマや区切り文字はありません
• ファイルはUTF-8エンコーディングを使用する必要があります
• ファイル末尾の改行はオプションです
• 空行はほとんどのパーサーで無視されます

'{'"name":"Alice","age":30,"city":"New York"'}'
'{'"name":"Bob","age":25,"city":"London"'}'
'{'"name":"Charlie","age":35,"city":"Tokyo"'}'

注意：各行は完全で独立したJSONオブジェクトです。行間にカンマはなく、外側の配列で囲まれていません。

JSONLファイルの読み方

JSONLファイルは、行ごとのテキスト処理をサポートするあらゆるツールで読み取ることができます。最も一般的な方法は以下の通りです：

# 最初の5行を表示
head -n 5 data.jsonl

# 総行数（レコード数）をカウント
wc -l data.jsonl

# jqで各行を整形表示
cat data.jsonl | jq .

# フィールド値でフィルタリング
cat data.jsonl | jq 'select(.age > 30)'

import json

with open('data.jsonl', 'r') as f:
    for line in f:
        record = json.loads(line)
        print(record['name'])

import '{' createReadStream '}' from ''fs'';
import '{' createInterface '}' from ''readline'';

const rl = createInterface('{'
  input: createReadStream(''data.jsonl'')
'}');

for await (const line of rl) '{'
  const record = JSON.parse(line);
  console.log(record.name);
'}'

JSONLにコメントを追加できますか？

いいえ。JSONL仕様はコメントをサポートしていません。JSONLファイルの各行は有効なJSON値でなければならず、JSON自体にコメント構文はありません。

データと一緒にメタデータや注釈を含める必要がある場合、一般的な回避策は以下の通りです：

• 1JSONオブジェクトにメタデータフィールドを追加：'{'"_comment": "テストデータ", "name": "Alice"'}'
• 2JSONLファイルと一緒に別のメタデータファイルを使用
• 3ファイルの最初の行にメタデータを追加：'{'"_meta": '{'"version": "1.0", "created": "2026-01-15"'}''}'

「コメント」フィールドは通常のデータとして解析されることに注意してください。JSONLファイルを消費するアプリケーションは、メタデータフィールドを無視するように設計する必要があります。

一般的なユースケース

無料のJSONLツールを試す

JSONLの構文を検証し、形式間の変換やファイルの表示が可能です — すべてブラウザ内で完結します。