セマンティックバージョニング とは？

それぞれ意味が違うからだよ。SemVerに従う1.0.0以降のリリースでは、公開APIの互換性を壊す変更はメジャー、互換性を保つ機能追加はマイナー、互換性を保つバグ修正はパッチを上げる。変更した行数の大小ではなく、利用者に公開するAPIへの影響が中心なんだ。

以前の公開APIを使っていたコードが、新しい版でもその契約どおりに使えることだよ。2.5.3から、APIを壊す変更なら3.0.0、互換性を保つ機能追加なら2.6.0、バグ修正なら2.5.4にする。上位の番号を上げたら下位を0に戻す。公開APIを非推奨にしたときもマイナーを上げるんだ。

npmの通常のバージョン範囲では、^1.2.3は1.2.3以上2.0.0未満、~1.2.3は1.2.3以上1.3.0未満を許す指定だよ。単に「1.xなら全部」ではなく、下限もある。これらの範囲ではプレリリースは通常除外される。許すバージョンの範囲と、更新後に自分のコードが動く保証は別なので、変更内容も確認しよう。

SemVerでは0.y.zは初期開発用で、公開APIが安定しているとは扱わず、何でも変わりうる段階だよ。npmのキャレットも0.xでは範囲が狭くなり、^0.1.0は0.1.0以上0.2.0未満を許す。メジャーが同じだから互換性が保たれる、と一律に判断できないんだ。

1.2.3-beta.1のようなプレリリースは、通常版の1.2.3より低い優先順位になるよ。+build.7のようなビルド情報は、バージョンの優先順位の比較に影響しない。すべてのソフトウェアがSemVerに従うとは限らないので、番号の意味を確かめ、CHANGELOGや移行ガイドと必要なテストで更新の影響を確認しよう。