npm-check-updates

설치 방법

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`	글로벌 패키지의 최신 버전 확인.