📖 semver 범위 해석기 | 어디까지 올라갈까?

Q: ^1.2.3 은 결국 어디까지 설치되나요?

1.2.3 이상 2.0.0 미만입니다. 캐럿은 왼쪽에서 0 이 아닌 첫 자리를 고정하므로 메이저가 1 로 묶이고, 1.9.9 까지는 올라가지만 2.0.0 은 들어오지 않습니다.

Q: ~1.2 와 ^1.2 는 어떻게 다른가요?

틸드는 패치 자리만 올리므로 1.2.0 이상 1.3.0 미만입니다. 캐럿은 메이저를 고정하므로 1.2.0 이상 2.0.0 미만이 되어 마이너 업데이트까지 받아들입니다.

Q: 버전 자리를 생략하면 어떻게 읽히나요?

생략한 자리는 와일드카드처럼 그 자리 전체를 뜻합니다. 1.2 는 1.2.0 이상 1.3.0 미만이고 1 은 1.0.0 이상 2.0.0 미만입니다. 1.2.x 도 1.2 와 같습니다.

범위 문자열

package.json 의 dependencies 에 적힌 값을 그대로 붙여 넣으세요. || 로 이어진 범위도 각각 풀어 줍니다.

package.json 의 범위 한 줄이 실제로 허용하는 버전

의존성 목록에 적힌 ^1.2.3 이 어디까지 올라가는지는 기호마다 규칙이 달라 헷갈립니다. 범위 문자열을 하나 넣으면 >=·< 구간으로 바꿔 보여 주고, 하한과 상한이 경계를 포함하는지, 허용되는 버전과 제외되는 버전의 예, 업데이트가 어디까지 올라갈 수 있는지를 정리합니다. 비교자별 해설도 표로 함께 나옵니다.

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

이 도구는 범위 하나를 풀어 설명하며, 범위 두 개의 포함 관계를 비교하는 일은 하지 않습니다. 프리릴리스 태그와 하이픈 범위는 해석하지 않고 반려합니다. 실제 설치 버전은 레지스트리에 올라간 목록과 패키지 매니저 해석기가 결정합니다. 2026년 10월 기준입니다.

자주 묻는 질문

^1.2.3 은 결국 어디까지 설치되나요?

1.2.3 이상 2.0.0 미만입니다. 캐럿은 왼쪽에서 0 이 아닌 첫 자리를 고정하므로 메이저가 1 로 묶이고, 1.9.9 까지는 올라가지만 2.0.0 은 들어오지 않습니다.

~1.2 와 ^1.2 는 어떻게 다른가요?

틸드는 패치 자리만 올리므로 1.2.0 이상 1.3.0 미만입니다. 캐럿은 메이저를 고정하므로 1.2.0 이상 2.0.0 미만이 되어 마이너 업데이트까지 받아들입니다.

버전 자리를 생략하면 어떻게 읽히나요?

생략한 자리는 와일드카드처럼 그 자리 전체를 뜻합니다. 1.2 는 1.2.0 이상 1.3.0 미만이고 1 은 1.0.0 이상 2.0.0 미만입니다. 1.2.x 도 1.2 와 같습니다.

📖package.json semver 범위 해석기

관련된 도구

Semver 버전 범위 비교기

.editorconfig 생성기

package.json 의 범위 한 줄이 실제로 허용하는 버전

자주 묻는 질문

관련된 도구

Semver 버전 범위 비교기

.editorconfig 생성기

package.json 의 범위 한 줄이 실제로 허용하는 버전

자주 묻는 질문

같은 카테고리 도구