npm-check-updates 사용 가이드
1. 필요성
npm-check-updates(ncu)는 프로젝트의 package.json에 있는 의존성 패키지들을 최신 버전으로 업그레이드할 수 있게 도와주는 도구입니다.
왜 필요할까요?
- 자동화된 버전 확인: 수십 개의 패키지를 일일이 확인하지 않고, 한 번에 최신 버전을 확인할 수 있습니다
- 시간 절약: npm outdated보다 더 강력하며, package.json을 직접 업데이트해줍니다
- 보안 및 성능 개선: 최신 버전으로 업데이트하여 보안 패치와 성능 개선 사항을 적용할 수 있습니다
- 유지보수 용이: 프로젝트를 최신 상태로 유지하여 기술 부채를 줄일 수 있습니다
2. 설치 방법
pnpm 전역 설치
pnpm add -g npm-check-updates
3. 간단한 사용법
기본 사용법
# 업데이트 가능한 패키지 확인만 하기
ncu
# package.json 업데이트하기
ncu -u
# 업데이트 후 패키지 설치
ncu -u
npm install
유용한 옵션들
# 특정 패키지만 확인
ncu react react-dom
# 메이저 버전 업데이트 포함
ncu --target latest
# 마이너/패치 업데이트만
ncu --target minor
ncu --target patch
# 특정 패키지 제외
ncu --reject react,vue
# 특정 패키지만 포함
ncu --filter "react-*"
# 대화형 모드 (선택적 업데이트)
ncu -i
실행 예시
# 1단계: 업데이트 가능한 패키지 확인
$ ncu
Checking package.json
[====================] 15/15 100%
express ^4.17.1 → ^4.18.2
mongoose ^6.0.0 → ^7.0.3
jest ^27.0.0 → ^29.5.0
Run ncu -u to upgrade package.json
# 2단계: package.json 업데이트
$ ncu -u
# 3단계: 실제 패키지 설치
$ npm install
4. 주의 사항
⚠️ Breaking Changes 주의
- 메이저 버전 업데이트는 breaking changes를 포함할 수 있습니다
- 업데이트 전 각 패키지의 CHANGELOG를 확인하는 것이 좋습니다
- 특히 주요 프레임워크나 라이브러리는 신중하게 업데이트해야 합니다
📦 단계적 업데이트 권장
# 안전한 업데이트 순서
# 1. 패치 버전만 먼저 업데이트
ncu --target patch -u
npm install
# 2. 마이너 버전 업데이트
ncu --target minor -u
npm install
# 3. 메이저 버전은 하나씩
ncu react -u
npm install
🔒 버전 관리 팁
- package-lock.json 또는 yarn.lock 파일도 함께 커밋하세요
- Git 브랜치를 만들어 업데이트를 테스트한 후 병합하세요
🚫 업데이트하지 말아야 할 경우
- 프로덕션 배포 직전
- 중요한 기능 개발 중
- 패키지의 메이저 버전이 올랐는데 마이그레이션 가이드를 읽지 않았을 때
- 팀원들과 사전 협의 없이 대규모 업데이트를 진행하는 경우
💡 추가 권장 사항
# .ncurc.json 설정 파일 생성 가능
{
"upgrade": true,
"target": "minor",
"reject": [
"react",
"react-dom"
]
}
기억하세요: npm-check-updates는 강력한 도구이지만, 무분별한 업데이트는 프로젝트를 망칠 수 있습니다. 항상 신중하게, 테스트와 함께 진행하세요!
이 글은 AI를 통해서 작성되었습니다.