🔖 Semver 버전 범위 비교기 | 두 범위가 겹칠까?

Q: ^0.2.3 과 ^1.2.3 은 왜 다르게 동작하나요?

캐럿은 왼쪽에서 0 이 아닌 첫 자리를 고정합니다. 1.x 에서는 메이저가 그 자리라 1.2.3 이상 2.0.0 미만이 되고, 0.2.x 에서는 마이너가 그 자리라 0.2.3 이상 0.3.0 미만이 됩니다. 0.0.3 이면 패치만 남아 0.0.4 미만입니다.

Q: 1.0.0-beta.1 같은 프리릴리스는 왜 안 되나요?

프리릴리스는 범위에 기본으로 포함되지 않고, 같은 버전에 프리릴리스 비교자가 있을 때만 들어옵니다. 규칙이 갈라지는 구간이라 틀린 답을 내지 않도록 하이픈이 있는 범위는 반려합니다.

Q: 일부만 겹친다는 결과는 무슨 뜻인가요?

두 범위가 공통으로 허용하는 버전이 있지만, 어느 쪽도 상대를 완전히 품지 못한다는 뜻입니다. 각 범위에만 있는 버전 예를 함께 보여주니 그 버전을 보면 차이를 바로 알 수 있습니다.

범위 A

범위 B

^ 는 왼쪽에서 0 이 아닌 첫 자리를 고정합니다. ^0.2.3 은 0.3.0 미만, ^0.0.3 은 0.0.4 미만만 허용합니다.

두 범위가 같은 버전을 가리키는지 확인하기

의존성 하나를 여러 패키지가 서로 다른 범위로 요구할 때, 그 둘이 함께 만족되는 버전이 있는지 판단해야 합니다. 범위 두 개를 넣으면 각 범위를 >=·< 구간으로 정규화해서 보여주고, 포함 관계와 겹치는 구간을 계산합니다. 어느 쪽에만 해당하는 버전 예도 함께 뽑아 줍니다.

해석은 semver 범위 규칙을 그대로 따릅니다. 캐럿은 왼쪽에서 0 이 아닌 첫 자리를 고정하므로 ^1.2.3 은 2.0.0 미만, ^0.2.3 은 0.3.0 미만, ^0.0.3 은 0.0.4 미만입니다. 틸드는 패치만 올리고, x 와 생략된 자리는 그 자리 전체를 뜻하며, || 는 구간을 합집합으로 잇습니다. 프리릴리스 버전은 범위에 기본 포함되지 않습니다.

프리릴리스 태그가 들어간 범위와 하이픈 범위는 해석하지 않고 반려합니다. 또 이 도구는 범위 하나를 풀어 설명하지 않고 범위 두 개의 관계만 계산합니다. 설치될 버전을 고르는 것은 패키지 매니저의 해석기와 레지스트리에 올라간 버전 목록에 달려 있습니다. 2026년 10월 기준입니다.

자주 묻는 질문

^0.2.3 과 ^1.2.3 은 왜 다르게 동작하나요?

캐럿은 왼쪽에서 0 이 아닌 첫 자리를 고정합니다. 1.x 에서는 메이저가 그 자리라 1.2.3 이상 2.0.0 미만이 되고, 0.2.x 에서는 마이너가 그 자리라 0.2.3 이상 0.3.0 미만이 됩니다. 0.0.3 이면 패치만 남아 0.0.4 미만입니다.

1.0.0-beta.1 같은 프리릴리스는 왜 안 되나요?

프리릴리스는 범위에 기본으로 포함되지 않고, 같은 버전에 프리릴리스 비교자가 있을 때만 들어옵니다. 규칙이 갈라지는 구간이라 틀린 답을 내지 않도록 하이픈이 있는 범위는 반려합니다.

일부만 겹친다는 결과는 무슨 뜻인가요?

두 범위가 공통으로 허용하는 버전이 있지만, 어느 쪽도 상대를 완전히 품지 못한다는 뜻입니다. 각 범위에만 있는 버전 예를 함께 보여주니 그 버전을 보면 차이를 바로 알 수 있습니다.

🔖Semver 버전 범위 비교기

관련된 도구

package.json semver 범위 해석기

코드 의존성 복잡도 계산기

두 범위가 같은 버전을 가리키는지 확인하기

자주 묻는 질문

관련된 도구

package.json semver 범위 해석기

코드 의존성 복잡도 계산기

두 범위가 같은 버전을 가리키는지 확인하기

자주 묻는 질문

같은 카테고리 도구