セマンティック バージョニング (SemVer) は、ソフトウェアのバージョン番号の付与と更新に関する標準仕様を定めています:MAJOR.MINOR.PATCH。
3つの構成要素
$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$
- MAJOR (
1.0.0->2.0.0): 後方互換性のない破壊的変更 (Breaking Changes)。 - MINOR (
1.0.0->1.1.0): 後方互換性を保った機能追加。 - 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 | 無制限のワイルドカード |