896バイトの同じYAMLを読むと、PyYAMLの中央値は0.9409 ms、ruamel.yamlは1.4055 msでした。
意外だったのは書き方です。同じ中身を角かっこで詰めた形式のほうが、バイト数は少ないのに、どちらの部品でも遅くなりました。
値と型は、測った六つの入力のすべてで、どちらの部品も期待どおりに読み込みました。差がついたのは時間のほうです。
読み込んだ値の一致:全12の出力が期待どおりでした
六つの入力を二つの部品で読んだ12の出力は、どれも期待値と値も型も一致しました。
確かめ方は、配列の全要素を最後までたどり、型と値の両方を比べる方法です。
値が同じに見えても、文字列と整数が入れ替わっていると困ります。そこで型まで照合しました。
照合は時間を計る前と後の両方で行い、期待値は入力とは別の手順で作りました。さらに、二つの部品の出力どうしも突き合わせています。
| 項目 | PyYAML | ruamel.yaml |
|---|---|---|
| 読み込みの呼び方 | yaml.safe_load(text) | YAML(typ='safe', pure=True).load(text) |
| 期待値との一致(六入力) | すべて一致 | すべて一致 |
| 相手の出力との一致 | 一致 | 一致 |
単純な型のYAML:文字列・整数・配列だけを二つの書き方で用意した
入力は自作で、中身は文字列・整数・配列だけです。
レコードの数は10・100・1000の三段階です。それぞれを、ブロック形式とフロー形式の二つで書きました。
ブロック形式は、字下げで入れ子を表す、ふつうのYAMLの書き方です。フロー形式は、角かっこで詰める書き方で、JSONによく似ています。
中身には、日本語、絵文字、空の文字列、引用符、改行、タブを入れました。
yes・on・日付に見える文字列は、すべて二重引用符で囲み、型の解釈が揺れないようにしています。
処理時間:六つの条件すべてでPyYAMLの中央値が短い
同じ入力を何度も読み、1回あたりの平均時間を7バッチ分並べて、中央値を取りました。単位はミリ秒(ms)です。
| 入力 | UTF-8のバイト数 | 1バッチの読み込み回数 | PyYAML(中央値) | ruamel.yaml(中央値) |
|---|---|---|---|---|
| ブロック形式・10レコード | 896 | 10回 | 0.9409 ms | 1.4055 ms |
| ブロック形式・100レコード | 9250 | 2回 | 9.2436 ms | 13.5925 ms |
| ブロック形式・1000レコード | 95667 | 1回 | 99.7279 ms | 157.8375 ms |
| フロー形式・10レコード | 478 | 10回 | 0.9565 ms | 1.4552 ms |
| フロー形式・100レコード | 5052 | 2回 | 11.3177 ms | 16.7440 ms |
| フロー形式・1000レコード | 53669 | 1回 | 132.9690 ms | 185.3274 ms |
入力が大きいほど、1回あたりの時間は伸びます。95667バイトのブロック形式では、PyYAMLが99.7279 ms、ruamel.yamlが157.8375 msでした。
大きい入力は時間がかかるため、1バッチの読み込み回数を減らしています。回数は二つの部品で同じです。
短く書いたフロー形式は、速くならなかった
同じ中身を詰めて書いたフロー形式は、バイト数が少ないのに、10・100・1000レコードのどれでも、どちらの部品も時間が長くなりました。
100レコードで見ると、PyYAMLはブロック形式の9.2436 msに対し、フロー形式は11.3177 msです。ruamel.yamlも13.5925 msから16.7440 msへ延びました。
入力は9250バイトから5052バイトへ減っています。
バイト数だけでは、読み込みの時間は見積もれません。
ここが落とし穴:この時間は、ruamel.yamlの既定の設定ではありません
表の時間は、どちらもPythonだけで動く safe 読み込みの数字です。
ruamel.yaml公式のドキュメントでは、既定のモードが round-trip(読んだ内容を書き戻す往復)です。
測ったのは YAML(typ='safe', pure=True) で、既定のモードとは別の設定です。
PyYAMLにも、LibYAML(C言語で書かれた高速な部品)を使う CLoader という別の読み込み口があります。測ったのは yaml.safe_load のPython実装です。
速さを重く見る人は、本番に近い設定で測り直してください。
出典: PyYAML 公式のREADME、ruamel.yaml 公式のドキュメント(2026年11月19日確認)
選び方:読み込みの速さならPyYAML、書き戻しまで考えるならruamel.yaml
測った範囲では、読み込みを速くしたい人はPyYAMLが有利です。読んだ内容を書き戻す作業も考えるなら、既定が round-trip の ruamel.yaml も候補に入ります。
選ぶ理由は三つです。
- 時間は、896バイトの入力でPyYAMLが0.9409 ms、ruamel.yamlが1.4055 ms。95667バイトの入力でも99.7279 ms対157.8375 msです。
- 値と型は、六つの入力のすべてで両方とも期待どおりでした。差がつくのは時間です。
- 設定は、どちらもPythonだけで動く safe 読み込みで測っています。使う設定が変われば、順番も変わりえます。
PyYAML公式のREADMEは、信頼できない入力を読むときに yaml.safe_load を使うよう案内しています。
二つの部品の要点を、一枚にまとめます。
二つの部品の一言まとめ
PyYAML
Pythonで書かれた機能そろいの枠組みです。手元の測定では全ての入力で中央値が短く、safe読み込みの案内もあります。
ruamel.yaml
Python用のYAML読み込み・書き出しパッケージです。既定は round-trip モードで、測ったのは別の safe 設定です。
この記事の時間
どちらもPythonだけで動く safe 読み込みで測った数字です。C言語の高速な部品を使う設定とは別です。
| 項目 | PyYAML | ruamel.yaml |
|---|---|---|
| 測った処理時間 | 六つの入力すべてで中央値が短い | 六つの入力すべてで中央値が長い |
| 読み込んだ値の一致 | 期待値と一致 | 期待値と一致 |
| 測った設定 | yaml.safe_load(Python実装) | YAML(typ='safe', pure=True) |
| 向く人 | 読み込みの時間を短くしたい人 | 読んだ内容を書き戻す作業も考える人 |
| 向かない人 | 書き戻しを重く見る人(ruamel.yamlも比べる) | safe 読み込みの時間だけで選ぶ人 |
| 次に確かめること | CLoader を使う設定で測り直す | 既定の round-trip モードで測り直す |
自分の使い方から選ぶ順番は、この流れ図でたどれます。
PyYAMLとruamel.yamlの選び方
- 1. 読み込みの時間を最優先にしますか?はい → PyYAMLを選びます。手元の測定では六つの入力すべてで中央値が短くなりました。いいえ → 次は質問2です。
- 2. 読んだ内容を書き戻す作業もありますか?はい → ruamel.yamlも候補に入れ、既定の round-trip モードで測り直します。いいえ → 次は質問3です。
- 3. 信頼できない入力を読みますか?はい → PyYAMLなら yaml.safe_load を使います。READMEが案内している読み方です。いいえ → どちらでも足ります。使い慣れたほうから始めて構いません。
測定と比較の範囲
測定は2026年11月19日に、このMac1台のCPUだけで行いました。
| 項目 | 内容 |
|---|---|
| OS・CPU | macOS 27.2.1・arm64・論理CPU12(Mac機種名とCPU製品名は記録していません) |
| Python | CPython 3.14.10(GIL版) |
| PyYAML | 6.0.3 |
| ruamel.yaml | 0.19.1 |
| 実行場所 | 一時の仮想環境・CPUのみ・Metalなし |
| 試行 | 各入力・各部品で、準備の1バッチのあとに7バッチ。順序は交互。計84の測定バッチ |
| 時計 | perf_counter_ns(整数のナノ秒)。循環GCは計時中だけ停止 |
| 含むもの | Pythonのループ、読み込み、メモリの割り当て、結果の解放 |
| 含まないもの | 導入、import、YAMLインスタンスの初期構築、入力生成、検証、ファイル入出力 |
中央値は、バッチの時間を回数で割った1回あたりの平均を、7バッチ分並べて取っています。単発の読み込みの遅れを測ったものではありません。
入力は自作の文字列・整数・配列だけで、辞書・真偽値・null・小数・複数文書は入っていません。引用符なしの yes や on、アンカー、コメント、重複キー、無効な入力も対象外です。
書き出し、C拡張、ピークメモリ、起動やimportの時間、並列実行、ほかのOSやCPUとの比較も対象外です。
ほかのプロセスの負荷やCPU周波数は固定していません。統計的な有意差の検定も行っていないため、順位はこのMacと条件での観測です。
生データと再実行用のコードは、次のとおり公開しています。
出典
公式ページ(すべて2026年11月19日に確認)
- PyYAML 公式リポジトリ — https://github.com/yaml/pyyaml
- ruamel.yaml 公式ドキュメント — https://yaml.dev/doc/ruamel.yaml/
自前の計測(2026年11月19日実施)
- macOS 27.2.1・arm64・CPython 3.14.10・PyYAML 6.0.3・ruamel.yaml 0.19.1 の一時環境で、上の生データを取りました。
変更履歴
| 日付 | 内容 |
|---|---|
| 2026-11-19 | 初版 |
