# orjson と msgspec のローカルJSON処理実測

依頼: req-20261022-065 / 題材ID: orjson-msgspec-local-hikaku
測定日: 2026-11-04（Asia/Tokyo）。実行時刻のUTC生値は raw.json の started_at_utc / finished_at_utc。

## 判断と範囲

このMacの砂場で両方をCPU実行でき、読み込み・書き出し・処理時間の比較軸が成立した。
orjson 3.13.0 と msgspec 0.22.0 のJSON APIを実際に呼び出した。外部の速度表の転載は使っていない。
鍵、ログイン、有料API、買い物は不要。公開・X投稿・git commitは行っていない。

測定環境は macOS 27.2 / arm64 / CPython 3.14.10 / 論理CPU数 12。
CPU名の照会は砂場に拒否されたため取得不可。機種名やCPU製品名は推定していない。
両方ともネイティブCPU拡張を使う。機械学習やGPUのバックエンドを読み込まず、Metalの初期化を行う呼び出しもない。
権限の拡張、音声入出力、say、Bluetoothは使用していない。

## 入力と方法

再実行コードの corpus() が、英語・日本語それぞれ10 / 1,000 / 10,000件の人工レコードを生成する。
乱数や外部データを使わず、文字列（日本語条件は絵文字も含む）、整数、有限の二進数で正確に表せる小数、真偽値、null、配列、入れ子辞書を含めた。
生成コードをそのまま残し、各入力のUTF-8バイト数とSHA256を raw.json の cases[] に保存した。
個人情報や既存の利用者ファイルは入力にしていない。入力はメモリ上で生成し、一時入力ファイルを作らない。

- decode: 同一の標準json製・空白なしUTF-8 bytesを orjson.loads / msgspec.json.decode に渡す。
- encode: 同一のPython dict/listオブジェクトを orjson.dumps / msgspec.json.encode に渡す。
- roundtrip: 各ライブラリで同一入力をdecodeして、その結果をencodeする。加工処理は加えない。

msgspecの型指定・Struct・スキーマ検証は使わず、両者とも既定設定で通常のdict/listとbytesを扱う。
並列実行やキーのソートは行わない。ループ回数は10件で3,000回、1,000件で40回、10,000件で4回。
各入力×操作×ライブラリにつき1バッチのウォームアップ後、5バッチを計時した。
同じ条件では両者のループ回数をそろえ、試行ごとに実行順を交互に切り替え、条件開始側も交互にした。
計180バッチとウォームアップ36バッチを記録した。

perf_counter_ns()（mach_absolute_time）で各バッチの整数ナノ秒を取得した。
計時中のみ循環GCを止め、通常の参照カウントは動かした。各呼び出し結果はそのループ内で解放する。
Pythonループ、ネイティブ呼び出し、メモリ割当と結果解放を含む。
入力生成・取得・仮想環境・import・検証・ハッシュ・ディスクI/O・起動時間は含まない。
生値は trials[].elapsed_ns と loops に保存した。台帳の全180 assertion はこの整数生値を直接指し、identity / rounding=0 / tolerance=0 を使う。

## 結果

全6入力について、両者のdecode結果、encode結果を標準jsonで読み直した値、roundtrip結果を読み直した値が元データと一致した。
さらに両者のencode結果はバイト単位でも一致した。出力長とSHA256は cases[].validation に記録した。
10件の英語・日本語について両ライブラリの実際のJSON出力も保存した。
この一致は人工データ内の確認に限り、全JSON仕様への適合性や実運用での品質を保証しない。

下表はバッチ時間5回の中央値 ÷ ループ回数 ÷ 1,000,000 による1操作当たりms（小数6桁に丸めた参考表示）。
独立した1操作ずつのレイテンシー測定ではない。整数生値・最小/最大・集計値は raw.json にある。

| 入力 | 入力バイト | バッチ内回数 | 操作 | orjson 中央値 ms/操作 | msgspec 中央値 ms/操作 |
|---|---:|---:|---|---:|---:|
| en10 | 1,948 | 3000 | decode | 0.003790 | 0.004043 |
| en10 | 1,948 | 3000 | encode | 0.001422 | 0.001967 |
| en10 | 1,948 | 3000 | roundtrip | 0.005301 | 0.006215 |
| en1000 | 196,341 | 40 | decode | 0.406620 | 0.429886 |
| en1000 | 196,341 | 40 | encode | 0.126397 | 0.164259 |
| en1000 | 196,341 | 40 | roundtrip | 0.535581 | 0.602226 |
| en10000 | 1,992,877 | 4 | decode | 4.179000 | 4.516833 |
| en10000 | 1,992,877 | 4 | encode | 1.274261 | 1.638854 |
| en10000 | 1,992,877 | 4 | roundtrip | 5.489312 | 6.183771 |
| ja10 | 2,158 | 3000 | decode | 0.004146 | 0.005066 |
| ja10 | 2,158 | 3000 | encode | 0.001474 | 0.002023 |
| ja10 | 2,158 | 3000 | roundtrip | 0.006372 | 0.007940 |
| ja1000 | 217,341 | 40 | decode | 0.459420 | 0.552565 |
| ja1000 | 217,341 | 40 | encode | 0.136910 | 0.169352 |
| ja1000 | 217,341 | 40 | roundtrip | 0.674943 | 0.812527 |
| ja10000 | 2,202,877 | 4 | decode | 4.934479 | 5.938636 |
| ja10000 | 2,202,877 | 4 | encode | 1.398198 | 1.691510 |
| ja10000 | 2,202,877 | 4 | roundtrip | 6.966687 | 8.274781 |

## 限界

このMac・この版・この入力・この実行時のウォーム状態で得た結果である。
同時実行している他プロセスの影響、OSのスケジュール、キャッシュ、CPUの動作周波数は制御していない。
開始・終了のload averageを生データに残した。5試行のみで、プロセス再起動をまたぐ統計や有意差は調べていない。
小さい入力ではPythonループや割当の割合が大きい。

外部推論、AIの出力品質、実業務の品質・精度、スキーマ検証、MsgPack、dataclass、日時、NumPy、巨大整数、非有限数、無効JSON、重複キー、極端な入れ子、エラー処理は測っていない。
ディスク読み書き、メモリ使用量、コールド起動、ストリーミング、並列処理、別OS・別Python・別CPU、GPUも未測定。
片方の結果からもう片方の速度を推定した値は含めていない。

## 再実行

同じmacOS arm64 / 通常のGIL版CPython 3.14で、次を実行する（Pythonコードを許可形式のTXTで保存）。
既存の出力先は拒否する。台帳を書き換える処理は含めていない。

```sh
python3 measurements/orjson-msgspec-local-2026-11-04-req065-a1-replay.txt --output-dir /tmp/orjson-msgspec-rerun-new
```

公開wheelのダウンロード時だけ通信する。URL・固定バージョン・期待SHA256はコード内のWHEELSにある。
PyPI公開メタデータから取得したSHA256と、実際に取得したバイトのSHA256を照合してから使った。
追加依存やpipは使わず、wheelを新しい仮想環境に展開する。取得したwheelの来歴は dependencies.json に保存した。
TemporaryDirectory(dir='/tmp') の中にwheelと仮想環境、結果の作業領域を作り、終了時には成功・失敗とも削除する。
ワーカー成功後にだけ指定した新規出力先へ結果をコピーする。計時はローカルCPUで完結する。

## ファイルと照合

- orjson-msgspec-local-2026-11-04-req065-a1-raw.json: 環境、条件、入力と出力のhash、全180試行、36ウォームアップ、集計。
- orjson-msgspec-local-2026-11-04-req065-a1-dependencies.json: 公開wheelのURL、版、取得サイズ、検証したSHA256。
- orjson-msgspec-local-2026-11-04-req065-a1-run-log.txt: 成功した測定ワーカーの標準出力。
- orjson-msgspec-local-2026-11-04-req065-a1-en10-orjson-output.json / -en10-msgspec-output.json / -ja10-orjson-output.json / -ja10-msgspec-output.json: 実際の小サイズ出力。
- orjson-msgspec-local-2026-11-04-req065-a1-replay.txt: 入力生成・取得・測定・再実行コード。
- このREADME: 測定範囲と限界。

以上9ファイルを measurements/ と public/measurements/ に同じバイトで保存する。
台帳 topics.orjson-msgspec-local-hikaku の raw_sha256 は public側の全9ファイルを対象とする。
既存検査の実行とcommitは親が担当する。

## 公式資料

APIの出典（2026-11-04確認）。ここに掲載されたベンチマーク値は本測定には取り込んでいない。

- [orjson公式リポジトリ](https://github.com/ijl/orjson): loads / dumps。
- [msgspec公式リポジトリ](https://github.com/msgspec/msgspec): json.decode / json.encode。
