[Node.js] 소프트웨어 버전 관리 - 유의적 버전 (Semantic Versioning, SemVer)

 

유의적 버전이란?

유의적 버전은 소프트웨어 버전 관리를 위한 규칙으로, 프로젝트가 개발되는 특정한 시점의 상태에 의미를 부여해 숫자를 매기는 방식이다. Node.js와 npm은 이러한 유의적 버전 규칙을 따른다.

 

 

유의적 버전의 형식

 

유의적 버전은 마침표로 구분되는 세가지 숫자를 가진다. 각각의 숫자는 첫번째가 major, 두번째가 minor, 세번째가 patch라는 이름을 갖는다. 즉 3.2.1 버전은 major 버전이 3, minor 버전이 2, patch 버전이 1이라는 의미를 갖는다.

 

Major 버전 (주 버전)

major 버전은 기존 버전과는 호환되지 않는 새로운 버전이다. major 버전이 3버전이라고 했을 때, 직전 버전인 2버전과는 호환되지 않는다는 것이다. 기존 API가 삭제되거나 변경되어, 이전 버전과의 호환성이 깨진다면 major 버전이 올라간다.

 

Minor 버전 (부 버전)

minor 버전은 기존 버전과 호환되는 기능이 추가된 버전이다. 

 

Patch 버전 (수정 버전)

patch 버전은 기존 버전과 호환되는 버그 및 오타 등이 수정된 버전으로, 새로운 기능이 추가되지 않는다.

 

 

유의적 버전의 범위 지정

npm을 사용해서 패키지를 관리할 때, package.json에서 의존성 패키지 목록을 확인해보면 위 사진과 같이 유의적 버전 앞에 ^(캐럿, caret) 기호가 붙은 것을 볼 수 있다. 유의적 버전에서는 이렇게 앞에 특정 기호를 붙임으로써 버전의 범위를 지정할 수 있다.

 

캐럿 범위 (^, caret)

캐럿 범위를 사용하면 major 버전을 고정하고, minor 버전과 patch 버전의 업데이트를 허용한다. 예를 들어, ^3.2.1이라면, 3.x.x 버전에서 최신 버전까지 자동으로 업데이트가 가능하지만, 4.0.0 버전과 같이 major 버전의 변경은 허용되지 않는다.

 

틸드 범위 (~, tilde)

틸드 범위를 사용하면 major 버전과 minor 버전을 고정하고, patch 버전의 업데이트를 허용한다. 예를 들어, ~1.2.3이라면, 1.2.x 범위 내에서 patch 버전만 업데이트가 가능하다. 1.2.4, 1.2.5와 같은 patch 버전의 변경은 허용되지만, 1.3.0과 같은 부버전 또는 2.0.0 같은 major 버전의 변경은 허용되지 않는다.

 

 

npm 버전 관련 명령어

• npm install <package>@x.x.x : 정확히 x.x.x 버전의 패키지를 설치하거나 이미 설치된 패키지의 버전을 변경한다
• npm install <package>@^x.x.x : 버전 범위 내에서 최신 버전의 패키지를 설치하거나 이미 설치된 패키지의 버전을 변경한다.
• npm install <package>@latest : 패키지의 가장 최신 안정 버전을 설치하거나 이미 설치된 패키지의 버전을 가장 최신 버전으로 변경한다.
• npm update : package.json에 지정된 버전 범위 내에서 최신 버전으로 패키지를 업데이트한다.
• npm install <package> --save-exact : 기본적으로 package.json에는 버전 범위가 기록되지만, --save-exact 옵션을 사용하면 정확한 버전이 기록된다.