package.json 패키지 버전 자동 업데이트 하기 🍕 (npm-check-updates)

프로젝트가 길어지면 자연스럽게 사용하던 라이브러리들의 버전이 올라가게 된다.

때로는 새로운 기능이 추가되거나 보안 이슈가 해결되기도 하므로, 가능하면 주기적으로 최신 버전으로 유지하는 것이 좋다.

하지만 수동으로 하나하나 버전을 확인하고 업데이트하기란 쉽지 않다.....

이럴 때 사용할 수 있는 유용한 CLI 도구가 바로 npm-check-updates다!

 

npm-check-updates 설치

전역 설치로 사용하는 것이 일반적인 것 같다.

npm install -g npm-check-updates

 

 

주요 사용법

현재 프로젝트의 패키지를 모두 확인하기

ncu

ncu는 npm-check-updates의 줄임말로, 현재 package.json에 명시된 의존성 중 최신 버전이 존재하는 항목을 리스트업 해준다.

예를 들어 다음과 같이 출력될 수 있다.

 react            ^18.2.0  →  ^19.0.0
 typescript       ^5.3.3   →  ^5.4.5

 

 

실제 사용하면 이렇게 뜬다

 

버전 정보를 package.json에 반영하기

ncu -u

위 명령어를 실행하면 package.json의 버전 범위가 최신 버전 기준으로 자동 갱신된다.

 

이후 처리

의존성 버전을 갱신한 후에는 실제로 설치도 다시 해줘야 한다.

npm install

 

 

기타 옵션

• ncu --interactive: 하나씩 선택하며 업데이트 가능
• ncu '/^@types\//': 특정 패키지만 선택적으로 업데이트
• ncu --target minor: major, minor, patch 등 업데이트 수준 지정 가능

전체 옵션은 공식 문서를 참고하는 것이 좋다.

 

🍎 🍉 🍇 🍓 🍒

라이브러리 버전을 관리하는 것은 소프트웨어 유지보수의 중요한 부분이다.
npm-check-updates는 이를 손쉽게 자동화할 수 있도록 도와주는 매우 유용한 도구다.
정기적으로 실행해보며 의존성을 관리하는 습관을 들이면 좋다.

 

‼️ 다만, 자동으로 package.json 업데이트까지만 되므로 노드 모듈 설치 및 실제 동작이 잘 되는지는 직접 확인해야 한다 ‼️

참고자료 🍳

• npm-check-updates 공식 깃허브
• npm-check-updates 문서