知識 · IT·データ·DX

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

Semantic Versioning

📂IT・データ・DX⏱読了目安 2分📊実務🔗関連 2

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

一行定義
ソフトウェアのバージョンを「メジャー.マイナー.パッチ(例: 2.4.1)」の形で付け、数字を見るだけで変化の性格がわかるようにする規則。
このテーマを社内研修で📚 関連研修💬 研修のお問い合わせ
⚡ 3行要約
  • バージョンを メジャー.マイナー.パッチ で採番
  • 数字で変更の性質を把握
  • 互換性管理

セマンティックバージョニングが実際に変えるのは、更新の判断を誰がするのかという点です。ルールがなければリリースノートを人がすべて読んで決める必要がありますが、ルールがあればパッケージマネージャーが「マイナーバージョンまでは自動で上げ、メジャーバージョンには触れるな」という指示を機械的に実行します。package.json の ^1.4.0、Python の ~=1.4 のような表記がその指示文です。人の確認作業がツールの設定値へ移っていくのが核心で、だからこそ依存関係が200〜300個あるプロジェクトでも、メジャーバージョンが変わったものだけを人が確認する方式で回っていきます。

細かい条件にも、実務者がよく見落とす例外があります。0.y.z の区間は規則による保護を受けず、公式仕様も「0.x では互換性がいつ壊れてもおかしくない」と明記しています。1.0.0 を付けた瞬間から公開APIが固定される、ということです。1.0.0-beta.2 のようにハイフンの後ろに付くプレリリースは、正式版の 1.0.0 より低いバージョンとして扱われ、プラス記号の後ろのビルドメタデータは比較で完全に無視されます。Ubuntu 24.04 のように日付をバージョンとして使うCalVerとは目的が違うため、一つの組織内で混ぜて使うと混乱が増すだけです。

現場で最もよくある誤解は、バージョン番号を保証だと信じてしまうことです。番号はデプロイする人が自分で付ける宣言にすぎず、検証された事実ではありません。実際、パッチバージョンだと言いながら設定の既定値を変えて入れてくるライブラリは少なくなく、社内チームも「メジャーバージョンを上げると他チームが嫌がる」という理由で、互換性を壊す変更をマイナーバージョンに隠しがちです。ここにlockファイルをコミットしないと、同じインストールコマンドが開発者のPCと本番のサーバーで違う結果を出し、障害の原因を探すだけで数日が消えてしまいます。

この用語が登場する研修 · AI・DX
おすすめ研修 · おすすめ講師 · 簡易見積もり
🧮 ミニ見積もり・講師料の基準
約120万ウォン(約14万円)特別講義 2時間 · 20名以下 · 韓国語
この条件で正式な見積もりを依頼 →
💡 かんたんに言うと
2.4.1から先頭の数字(メジャー)が上がれば「大きな変更に注意」。数字を見るだけでアップデートの危険度が分かります。
実務でなぜ重要なのか
バージョン番号だけで「安全なアップデートかどうか」を判断できるようにして、複雑な依存関係の管理を予測可能にします。
由来と出典

GitHub共同創業者のトム・プレストン=ワーナーが整理した仕様(semver.org)で、オープンソースのエコシステムにおける事実上の標準になりました。

出典 · Semantic Versioning(semver.org)
事例で理解する

架空の事例で見てみましょう。役職員140名規模の物流SaaSを運営するA社は、昨年第4四半期だけでデプロイ直後の障害を3回経験しました。原因を追跡すると、3件すべて外部ライブラリの自動アップデートから始まっており、そのうち2件はバージョンの末尾の数字だけが変わった「バグ修正」でした。

  1. バックエンドリーダーのキム責任が1か月分のデプロイログを調べたところ、自動で上がったパッケージは47個で、lockファイルはリポジトリにコミットすらされていませんでした。
  2. CTOが「末尾の数字しか上がっていないのに、なぜサービスが止まるのか」と尋ねると、キム担当者は認証ライブラリが0.9.3から0.9.4に上がる際、トークンの有効期限の既定値が24時間から1時間に変わったコミットを画面に映しました。
  3. チームは0.xパッケージはバージョンを丸ごと固定し、キャレット範囲は1.0.0以上にだけ使い、lockファイルは例外なくコミットするという3行のルールを、リポジトリのREADMEの一番上に貼り付けました。
  4. 社内共通モジュール12個にも同じ基準を適用し、APIレスポンスのフィールドを一つでも削除したらメジャーバージョンを上げるという項目をコードレビューのチェックリストに入れました。初月には精算モジュールが2.7.0から3.0.0に上がりました。
  5. 半年後、デプロイ直後の障害は四半期3件から0件になり、アップデートPR1件をレビューする時間も平均40分から10分に減りました。
関連用語
この用語に関連する研修
📚Claude Codeで実務用ウェブサイトを作るナヌム経営コンサルティング 企業研修 · 対面/オンライン研修を見る →
このテーマで社内研修が必要でしょうか?
ご担当者さま向けの研修プログラム・お見積もりを、すぐにご覧いただけます。
研修のお問い合わせ
最終更新 2026-09-13 · 監修 金鍾赫

よくある質問

「互換性の破壊(メジャー)・機能追加(マイナー)・バグ修正(パッチ)」を区別して、変化の性格を明確にするためです。
0.xは「まだ安定化前」という意味で、互換性が頻繁に壊れることがあることを意味します。
「互換性の破壊(メジャー)・機能追加(マイナー)・バグ修正(パッチ)」を区別して、変更の性質を明確にするためです。
「まだ安定化前」という意味で、互換性が頻繁に壊れうることを意味します。