要点
yes・no・on・offは、今回の読み方ではPyYAMLだけが真偽値にした(出典: 自社の実測・2026-11-06)。- Goのyaml.v3は、読み込み先がbool型のフィールドなら
yes・no・onを真偽値にした(出典: 自社の実測・2026-11-06)。 - 引用符で囲んだ
"no"は、測った4ライブラリすべてで文字列になった(出典: 自社の実測・2026-11-06)。
何が困るのか:同じonでも読み込んだ型が違う
YAMLに書いたonやoffを、スイッチの名前として文字列で受け取りたい場合がある。しかし、同じ記述を別のライブラリで読むと、読み込み後の型まで同じになるとは限らない。今回の実測では、PyYAMLがonを真偽値のTrueにした一方、JavaScriptのjs-yamlとyaml、Goのyaml.v3を使ったマップへの読み込みでは、文字列の"on"になった。
真偽値とは、真または偽を表す値のことだ。文字列の"on"と真偽値のTrueは、今回の出力でも値と型が別々に記録されている。設定ファイルの見た目だけでは、この違いを判断できない。
測定環境はmacOS(APFS)で、Python 3.9.0、Node.js v22.23.4、Go go1.26.2 darwin/arm64を使用した。ライブラリはPyYAML 6.0.2、js-yaml 4.1.0、yaml 2.5.1、gopkg.in/yaml.v3 v3.0.1である。以下の比較は、この環境と素材に記録された読み方についての結果だ。
出典: 自社の実測(2026-11-06)
公式はどう書いているか:仕様と読み込み先の型を見る
YAML 1.1のBoolean型の定義には、yes・no・on・offに加え、y・nや大文字を使った表記も含まれている。一方、YAML 1.2.2のCore Schemaでは、真偽値の解決規則として次の記述がある。
true | True | TRUE | false | False | FALSE tag:yaml.org,2002:bool
出典: https://yaml.org/spec/1.2.2/ (取得日 2026-11-05)
この規則にはyes・no・on・offが入っていない。仕様上の違いを確認する際は、単に「YAMLの真偽値」とまとめず、どの版の規則を見ているかを区別する必要がある。
ただし、仕様の一覧だけで個々のライブラリの結果をすべて説明することもできない。たとえばYAML 1.1の定義に含まれるyとnは、今回測った4ライブラリでは、いずれも文字列だった。
出典: https://yaml.org/type/bool.html (取得日 2026-11-05)
出典: 自社の実測(2026-11-06)
Goのyaml.v3については、READMEが読み込み先の型による違いを明記している。
YAML 1.1 bools (yes/no, on/off) are supported as long as they are being decoded into a typed bool value. Otherwise they behave as a string. Booleans in YAML 1.2 are true/false only.
出典: https://github.com/go-yaml/yaml/tree/v3 (取得日 2026-11-05)
この記述では、yes/noやon/offをbool型へ読み込む場合と、それ以外の場合を分けている。「Goでは文字列になる」という説明だけでは、この条件が抜け落ちてしまう。
比較表:ライブラリと読み込み先でどう変わったか
実測では、Pythonはyaml.safe_load、js-yamlはload、yaml(npm)はparseを使用した。Goではyaml.Unmarshalでmap[string]anyへ読み込んだうえで、別途bool型のフィールドを持つ構造体にも読み込んでいる。
次の表は、素材の出力にある値と型を並べたものだ。Goの構造体では、yes・no・onを対象にしており、offの結果は記録されていない。
| ライブラリ・読み込み先 | yes |
no |
on |
off |
|---|---|---|---|---|
PyYAML・safe_load |
True / bool |
False / bool |
True / bool |
False / bool |
js-yaml・load |
"yes" / string |
"no" / string |
"on" / string |
"off" / string |
yaml(npm)・parse |
"yes" / string |
"no" / string |
"on" / string |
"off" / string |
yaml.v3・map[string]any |
"yes" / string |
"no" / string |
"on" / string |
"off" / string |
| yaml.v3・bool型のフィールド | true / bool |
false / bool |
true / bool |
実測なし |
PyYAMLの出力には、次の行がそのまま記録されている。
d_yes True bool
e_Yes True bool
f_no False bool
g_on True bool
h_off False bool
Goの構造体への読み込みでは、yes・no・onに対応するフィールドの出力が次のようになった。
{true false true} <nil>
同じyaml.v3でも、マップへの読み込みとbool型のフィールドへの読み込みでは結果が異なる。比較するときに必要なのはライブラリ名だけでなく、値を受け取る側の型である。
出典: 自社の実測(2026-11-06)
どちらを使うか:真偽値の表記と文字列を分ける
真偽値を書きたいなら、YAML 1.2.2のCore Schemaに記載されたtrue・falseを使う方針が立てられる。今回の入力に含まれるtrue・True・TRUEは、4ライブラリすべてで真偽値として読み込まれた。ただし、裸のfalseを独立した値として読む結果は、今回の入力と出力には含まれていない。仕様に書かれた規則と、実際に測った項目は区別したい。
出典: https://yaml.org/spec/1.2.2/ (取得日 2026-11-05)
文字列として扱いたい場合に参考になるのは、引用符を付けた"no"の結果だ。引用符のないnoはPyYAMLでFalseになったが、"no"は4ライブラリすべてで文字列になった。少なくとも、この値については引用符の有無による違いを実測で確認できている。
一方、Goのbool型フィールドへ引用符付きの値を読み込む組み合わせは、今回の記録にはない。引用符付き"no"が文字列になった結果を、未測定の読み込み先にまで広げて説明することはできない。
出典: 自社の実測(2026-11-06)
落とし穴:onとoffが一致しても、ほかの値は一致しない
on・offの結果が同じだからといって、ファイル内のほかの値まで同じ型になるとは限らない。たとえば010は、PyYAMLとyaml.v3では整数の8、js-yamlとyaml(npm)では数値の10になった。0o10はPyYAMLでは文字列で、ほかの3ライブラリでは数値の8だった。
1:30も差があり、PyYAMLでは整数の90、ほかでは文字列になっている。さらに日付の2026-11-05は、PyYAMLではdate、js-yamlではDate、yaml(npm)では文字列、yaml.v3ではtime.Timeになった。真偽値だけを確認して、読み込み結果全体が一致したと判断することはできない。
また、今回測っていない条件もある。PyYAMLのyaml.loadに別のLoaderを渡した場合や、yaml(npm)のversion: '1.1'オプションを指定した場合は未測定だ。KubernetesやGitHub Actionsが内部で使うライブラリも調べていないため、ここで示した結果をそれらのツールの挙動として扱うことはできない。
出典: 自社の実測(2026-11-06)
自分の環境で確かめる手順
PyYAMLを使える環境では、確認したいYAMLをd.ymlとして保存し、次のコマンドを実行すると、ライブラリの版と各値の表現、型名を確認できる。これは素材の測定コードをコマンドとして実行する手順であり、ここに新しい実行結果は載せていない。
python3 - <<'PY'
import yaml
d=yaml.safe_load(open('d.yml'));print(yaml.__version__)
for k,v in d.items(): print(k,repr(v),type(v).__name__)
PY
比較する入力には、引用符なしのnoと引用符付きの"no"をそれぞれ置くと、今回の実測と同じ観点で値と型を確認できる。Goで確認する場合も、マップへの読み込み結果だけで終えず、実際に使うフィールドの型を比較条件に含めたい。今回の記録では、その読み込み先の違いだけでも、yes・no・onの結果が変わっている。
出典: 自社の実測(2026-11-06)

コメント