빠른 참조

시맨틱 버저닝 (SemVer) 치트시트

시맨틱 버저닝 빠른 참조 가이드: MAJOR.MINOR.PATCH 규칙, 프리릴리스 태그, 빌드 메타데이터, 패키지 매니저 범위 지정자.

· 게시일

시맨틱 버저닝 (SemVer)은 소프트웨어 버전 번호를 부여하고 증가시키는 표준 규격을 정의합니다: MAJOR.MINOR.PATCH.

세 가지 구성 요소

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

  1. MAJOR (1.0.0 -> 2.0.0): 하위 호환성을 깨뜨리는 API 변경.
  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 제한 없는 와일드카드

참고 자료

관련 주제