SemVer セマンティック バージョン計算機 の詳細ガイド
SemVer 計算機(SemVer Calculator)は、セマンティック バージョニング(SemVer 2.0.0)の文字列や依存関係のバージョン範囲(レンジ制約)を解析・評価します。Major(メジャー)、Minor(マイナー)、Patch(パッチ)、プレリリースタグ、ビルドメタデータを構造的な要素に分解して詳細を表示します。
npm の package.json で使用される SemVer レンジ(キャレット `^1.2.3`、チルダ `~1.2.3`、範囲指定 `>=1.0.0 <2.0.0`、`1.x`、ワイルドカード `*`、論理和 `||` 式など)の適合性をテストし、バージョンリストの並べ替えや次の推奨バージョンアップのプレビューを行えます。
主な機能と特長
- SemVer 2.0.0 仕様(Major.Minor.Patch-prerelease+build)の完全な構文解析
- npm レンジ表現の評価: キャレット(^)、チルダ(~)、比較演算子、論理和(||)ロジックに対応
- 厳密なバージョン比較とソート診断(gt、lt、eq、satisfies)
- メジャー、マイナー、パッチの各リリースアップをプレビューする次バージョン自動計算
使い方
- 1
基準となるバージョン(例: `2.4.1`)またはレンジ式(例: `^2.3.0`)を入力します。
- 2
対象のリリース候補バージョンを入力し、指定したレンジを満たしているかをテストします。
- 3
判定結果、トークン分解の詳細、および次回推奨バージョンの計算結果を確認します。
主な活用シーン
- → package.json 内のキャレット(`^`)指定が原因で発生する予期せぬ依存関係のドリフト(バージョン乖離)を調査
- → npm publish や git tag を実行する前に、次にリリースすべき適切なバージョン番号を特定
- → モノレポワークスペースや共有 CI/CD ビルドスクリプトにおけるバージョン依存制約の妥当性を検証
関連ツール
HTML メタタグ / OGP 生成器
SEO タイトル、ディスクリプション、Open Graph、Twitter Cards メタタグのプレビュー生成。
.gitignore 生成ツール
Node、Python、Go、macOS、VSCode など 500+ のテンプレートから .gitignore を作成。
オープンソース ライセンス生成器
MIT、Apache 2.0、GPL v3、BSD など主要 OSS ライセンス条文の比較と生成。
README.md ジェネレーター
GitHub リポジトリ向け標準 README マークダウンの構成テンプレート作成。
コミットメッセージ作成支援
feat、fix、chore などの Conventional Commits 規格に準拠した Git コミット文を作成。
OpenAPI / Swagger ビューアー
Swagger / OpenAPI 3.x 定義ファイル(JSON / YAML)のグラフィカル API ドキュメント表示。
よくある質問とプライバシー
`^`(キャレット)と `~`(チルダ)の決定的な違いは何ですか?
`~1.2.3` は PATCH リリースのみを許容し(`>=1.2.3 <1.3.0` にマッチ)、`^1.2.3` は MINOR および PATCH の両方のリリースを許容します(`>=1.2.3 <2.0.0` にマッチ)。
ビルドメタデータ(例: `+build123`)はバージョンの優先順位比較に影響しますか?
いいえ。SemVer 2.0.0 仕様の第 10 項に基づき、ビルドメタデータは純粋な参考情報であり、バージョンの優先順位(precedence)を決定する際は無視する必要があります。