クイックリファレンス

セマンティック バージョニング (SemVer) チートシート

セマンティックバージョニングのクイックリファレンス:メジャー・マイナー・パッチの増分ルール、プレリリースタグ、ビルドメタデータ、パッケージマネージャのバージョン範囲指定。

· 公開日

セマンティック バージョニング (SemVer) は、ソフトウェアのバージョン番号の付与と更新に関する標準仕様を定めています:MAJOR.MINOR.PATCH。

3つの構成要素

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0): 後方互換性のない破壊的変更 (Breaking Changes)。
  2. MINOR (1.0.0 -> 1.1.0): 後方互換性を保った機能追加。
  3. PATCH (1.0.0 -> 1.0.1): 後方互換性を保ったバグ修正。

プレリリースとビルドメタデータ

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # ビルドメタデータ (+以降はバージョン優先度の判定では無視されます)

優先順位の並び: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


パッケージマネージャのバージョン範囲指定子

指定記号 対象バージョン 説明
1.2.3 1.2.3 完全一致
>1.2.3 1.2.4, 2.0.0, ... 指定より大きいバージョン
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 範囲指定
~1.2.3 >=1.2.3 <1.3.0 パッチバージョンのみ更新を許可
^1.2.3 >=1.2.3 <2.0.0 互換性を維持した更新 (マイナーとパッチの更新を許可)
^0.2.3 >=0.2.3 <0.3.0 0.x.x ではマイナー更新も破壊的変更とみなされます
* Any version 無制限のワイルドカード

参考リンク

関連テーマ