설치 방법
1. 전역 설치 (권장)
전역 설치를 통해 어디에서나 ncu 명령어를 사용할 수 있습니다.
npm install -g npm-check-updates
2. 로컬 설치
로컬 설치를 통해 특정 프로젝트에서만 ncu를 사용할 수 있습니다.
npm install npm-check-updates --save-dev
3. npx로 실행 (설치 없이)
npm-check-updates를 설치하지 않고 실행하려면 npx를 사용합니다.
npx npm-check-updates
npm-check-updates(ncu)는 의존성을 최신 상태로 유지하는 데 유용한 도구입니다. 아래는 npm-check-updates 명령어와 옵션을 정리한 테이블입니다.
주요 명령어와 옵션
| 명령어/옵션 | 설명 | 예시 |
|---|---|---|
ncu |
업데이트 가능한 모든 패키지를 표시. | ncu |
ncu -u |
package.json의 버전을 최신 버전으로 업데이트. |
ncu -u |
ncu -f <패키지명> |
특정 패키지의 버전만 업데이트. | ncu -f react |
ncu --reject <패키지명> |
특정 패키지를 제외하고 나머지 패키지를 업데이트. | ncu --reject lodash |
ncu -g |
글로벌(Global)로 설치된 패키지의 업데이트 가능 여부 확인. | ncu -g |
ncu --target <범위> |
특정 업데이트 범위를 지정(예: major, minor, patch). |
ncu --target major |
ncu --upgradeAll |
현재 node_modules에 있는 모든 패키지를 최신으로 업데이트. |
ncu --upgradeAll |
ncu --filter <패키지명> |
특정 패키지 필터링(업데이트할 패키지를 선택적으로 제한). | ncu --filter react* |
ncu --semverLevel <범위> |
semver 수준별 업데이트 가능 패키지 필터링(예: major, minor). |
ncu --semverLevel major |
ncu --json |
업데이트 가능한 패키지를 JSON 형식으로 출력. | ncu --json |
ncu --packageFile <경로> |
기본 package.json 대신 지정된 파일에서 의존성 업데이트. |
ncu --packageFile ./custom.json |
ncu --interactive |
CLI에서 업데이트 여부를 선택할 수 있는 인터페이스 제공. | ncu --interactive |
ncu --deep |
의존성의 의존성까지 확인하여 업데이트. | ncu --deep |
주요 옵션 설명
1. 특정 패키지만 업데이트 (f 옵션)
특정 패키지만 업데이트하려면 -f 옵션을 사용합니다.
ncu -f react
예: react의 최신 버전으로 업데이트.
2. 특정 패키지 제외 (-reject 옵션)
업데이트에서 특정 패키지를 제외하려면 --reject 옵션을 사용합니다.
ncu --reject react
예: react는 제외하고 나머지 의존성만 업데이트.
3. 특정 범위로 업데이트 (-target 옵션)
업데이트 범위를 지정하려면 --target 옵션을 사용합니다.
| 옵션 | 설명 |
|---|---|
patch |
패치 버전만 업데이트. (1.0.0 → 1.0.1) |
minor |
마이너 버전만 업데이트. (1.0.0 → 1.1.0) |
major |
메이저 버전까지 업데이트. (1.0.0 → 2.0.0) |
예:
ncu --target minor
4. 글로벌 패키지 업데이트 (g 옵션)
전역으로 설치된 패키지의 업데이트 여부를 확인하려면 -g 옵션을 사용합니다.
ncu -g
사용 예제
1. 의존성 상태 확인
현재 프로젝트의 업데이트 가능 패키지 확인:
ncu
2. 전체 패키지 업데이트
package.json의 모든 패키지를 최신 버전으로 수정:
ncu -u
npm install
3. 특정 패키지만 업데이트
react와 redux만 업데이트:
ncu -f react redux
4. 특정 패키지를 제외
lodash는 제외하고 나머지 의존성만 업데이트:
ncu --reject lodash
5. 특정 업데이트 범위
메이저 업데이트만 확인:
ncu --target major
6. JSON 형식 출력
업데이트 가능한 패키지를 JSON으로 출력:
ncu --json
자주 사용하는 명령어 요약
| 명령어 | 설명 |
|---|---|
ncu |
업데이트 가능한 패키지 목록 확인. |
ncu -u |
모든 의존성을 최신 버전으로 업데이트. |
ncu -f <패키지명> |
특정 패키지의 버전만 업데이트. |
ncu --reject <패키지명> |
특정 패키지를 제외하고 업데이트. |
ncu --target major |
메이저 버전 업데이트만 표시. |
ncu -g |
글로벌 패키지의 최신 버전 확인. |