지식 · IT·데이터·DX
시맨틱 버저닝
Semantic Versioning
📂IT·데이터·DX⏱읽기 1분📊실무🔗관련 2
시맨틱 버저닝이란?
한 줄 정의
소프트웨어 버전을 '주.부.수(예: 2.4.1)'로 매겨, 숫자만 봐도 변화의 성격을 알게 하는 규칙.
⚡ 3줄 요약
- 버전을 주.부.수로 매김
- 숫자로 변화 성격 파악
- 호환성 관리
시맨틱 버저닝은 버전 번호를 MAJOR.MINOR.PATCH 세 자리로 매기는 약속입니다. 맨 앞(주)은 기존과 호환 안 되는 큰 변경, 가운데(부)는 호환되는 기능 추가, 맨 뒤(수)는 버그 수정을 뜻합니다. 예를 들어 2.4.1 → 3.0.0은 '큰 변경, 주의 필요'를, → 2.5.0은 '기능 추가', → 2.4.2는 '버그 수정'을 의미합니다.
이 규칙 덕분에 라이브러리를 업데이트할 때 '이게 안전한 변경인지, 코드가 깨질 위험이 있는지'를 숫자만 보고 짐작할 수 있습니다. 수많은 오픈소스 패키지가 이 규칙을 따라, 의존성 관리가 예측 가능해집니다. 바이브 코딩으로 패키지를 다룰 때 꼭 알아야 할 관례입니다.
💡 쉽게 말하면
2.4.1에서 앞자리(주)가 오르면 '큰 변경 주의' — 숫자만 보고 업데이트 위험을 압니다.
실무에서 왜 중요한가
버전 숫자만으로 '안전한 업데이트인지'를 판단하게 해, 복잡한 의존성 관리를 예측 가능하게 만듭니다.
유래와 출처
톰 프레스턴워너(GitHub 공동창업자)가 정리한 규격(semver.org)으로, 오픈소스 생태계의 사실상 표준이 됐습니다.
출처 · Semantic Versioning(semver.org)
사례로 이해하기
예를 들어, 버전 숫자를 해석해봅시다.
- 형식 — 2.4.1 = 주.부.수 입니다.
- 주(2→3) — 호환 깨지는 큰 변경, 주의합니다.
- 부(4→5) — 호환되는 기능 추가입니다.
- 수(1→2) — 버그 수정, 안전합니다.
- 판단 — 숫자만 보고 업데이트 위험을 가늠합니다.
관련 용어
오픈소스소스코드를 누구나 보고, 쓰고, 고치고, 나눌 수 있게 공개한 소프트웨어. 오늘날 IT의 상당수가 오픈소스 위에 세워져 있다.기술 부채빠른 개발을 위해 '대충' 짠 코드가 쌓여 나중에 갚아야 할 '빚'처럼 되는 것. 방치하면 이자가 붙는다.
이 용어와 연결된 교육
📚Claude Code로 실무 웹사이트 만들기나눔경영컨설팅 기업교육 · 대면/온라인과정 보기 →이 주제로 사내 교육이 필요하신가요?
담당자 맞춤 커리큘럼·견적을 바로 받아보세요.
자주 묻는 질문
'호환 깨짐(주)·기능 추가(부)·버그 수정(수)'을 구분해, 변화의 성격을 명확히 하기 위해서입니다.
0.x는 '아직 안정화 전'이라는 뜻으로, 호환이 자주 깨질 수 있음을 의미합니다.
'호환 깨짐(주)·기능 추가(부)·버그 수정(수)'을 구분해 변화의 성격을 명확히 하기 위해서입니다.
'아직 안정화 전'이라는 뜻으로, 호환이 자주 깨질 수 있음을 의미합니다.