npm 최신 버전으로 업데이트 하는 방법

npm을 최신 버전으로 업데이트하는 방법에 대해 알아봅니다.

2025년 8월 30일

개요

프로젝트를 진행하다보면 패키지 관리자도 최신 버전으로 유지하는 것이 중요합니다. 특히 장기간 업데이트하지 않은 경우, 새로운 기능이나 보안 패치가 적용된 최신 버전으로 업데이트하는 것이 필요합니다.

프로젝트가 6개월 또는 1년이라는 장기 프로젝트도 있기 때문에, npm과 같은 패키지 관리자를 최신 버전으로 유지하는 방법을 알아두는 것이 좋습니다.

단, 너무 자주 업데이트하는 것은 오히려 프로젝트에 문제를 일으킬 수 있으므로, 적절한 주기로 업데이트하는 것이 중요합니다.

너무 자주 업데이트하거나 최신버전에 집착하다보면 각 라이브러리나, 프레임워크의 호환성 문제로 인해 프로젝트에 문제가 발생할 수 있고, 오히려 개발 생산성이 떨어질 수 있습니다.

예를들어, next.js 13버전에서 14버전으로 넘어가면서 많은 변화가 있었고, tailwindcss도 3버전에서 4버전으로 넘어가면서 많은 변화가 있었습니다. 이러한 변화는 프로젝트에 큰 영향을 미칠 수 있습니다.

따라서, 안정적인 버전을 유지하면서도 주기적으로 업데이트하는 것이 좋습니다.

패키지 업데이트도 중요하지만, 주요 프레임워크, 라이브러리의 업데이트 내용을 공식문서에서 꼼꼼히 살펴보고, 변경된 내용이 프로젝트에 미치는 영향을 고려하는 것이 중요합니다.

이 블로그에서는 기존 프로젝트의 npm을 업데이트하는 방법과 전역적으로 설치된 npm을 업데이트하는 방법을 다룹니다.

본 블로그는 npm 패키지 관리자를 기준으로 작성되었습니다. yarn, pnpm 등 다른 패키지 관리자에 대한 업데이트 방법은 다를 수 있습니다.

업데이트 전에는 반드시 프로젝트를 백업하거나 git과 같은 버전 관리를 통해 변경 사항을 추적할 수 있도록 해야 합니다. 업데이트 과정에서 문제가 발생할 수 있으므로, 신중하게 진행하세요.

1. 현재 설치된 패키지 상태 확인하기

다음 명령어는 현재 프로젝트에 설치된 패키지를 터미널에서 확인할 수 있습니다.

bash

npm list

만약 에러가 발생한다면, `sudo` 권한이 필요할 수 있습니다. 이 경우 `sudo npm ~` 명령어를 사용해보세요.

이 명령어는 현재 프로젝트에 설치된 모든 패키지와 그 버전을 트리 구조로 보여줍니다. --depth=0 옵션을 추가하면 최상위 패키지만 표시할 수 있습니다.

bash

npm list --depth=0

터미널을 확인하면 설치된 패키지명과 버전 그리고 설치된 패키지의 경로를 확인할 수 있습니다.

글로벌로 설치된 패키지를 확인하려면 -g 옵션을 사용합니다.

bash

npm list -g --depth=0

특정 패키지의 버전을 확인하려면 다음 명령어를 사용합니다.

bash

npm list <패키지명>
 
# 예시
npm list react

2. 업데이트 가능한 패키지 확인하기

업데이트 가능한 패키지를 확인하려면 다음 명령어를 사용합니다.

bash

npm outdated

이 명령어는 현재 설치된 패키지의 버전, 최신 버전, 그리고 원하는 버전을 보여줍니다. Current는 현재 설치된 버전, Wanted는 package.json에 지정된 버전, Latest는 npm 레지스트리에서 사용 가능한 최신 버전을 나타냅니다.

json 형식으로 출력하려면 --json 옵션을 추가합니다.

bash

npm outdated --json

특정 패키지의 상세 정보를 확인하려면 다음 명령어를 사용합니다.

bash

npm outdated <패키지명>
# 예시
npm outdated react

3. 패키지 업데이트하기

패키지를 업데이트하려면 다음 명령어를 사용합니다.

bash

npm update

이 명령어는 package.json 파일에 지정된 버전 범위 내에서 패키지를 최신 버전으로 업데이트합니다. 예를 들어, ^1.0.0로 지정된 패키지는 1.x.x 버전으로 업데이트됩니다.

특정 패키지를 업데이트하려면 다음 명령어를 사용합니다.

bash

npm update <패키지명>
# 예시
npm update react

특정 패키지를 최신 버전으로 강제로 업데이트하려면 다음 명령어를 사용합니다.

bash

npm install <패키지명>@latest
# 예시
npm install react@latest

이 명령어는 package.json 파일의 버전 범위와 상관없이 해당 패키지를 최신 버전으로 업데이트합니다.

글로벌로 설치된 패키지를 업데이트하려면 -g 옵션을 사용합니다.

bash

npm update -g
 
## 특정 글로벌 패키지 업데이트
npm update -g <패키지명>
 
# 예시
npm update -g npm

글로벌로 설치된 특정 패키지를 최신 버전으로 강제로 업데이트하려면 다음 명령어를 사용합니다.

bash

npm install -g <패키지명>@latest
# 예시
npm install -g npm@latest

npm-check-updates(ncu) 사용하기

npm-check-updates(ncu)는 package.json 파일의 버전 범위를 무시하고, 모든 패키지를 최신 버전으로 업데이트할 수 있는 도구입니다. 이 도구를 사용하면 프로젝트의 모든 패키지를 최신 버전으로 쉽게 업데이트할 수 있습니다.

먼저, npm-check-updates를 글로벌로 설치합니다.

bash

npm install -g npm-check-updates

설치가 완료되면, 다음 명령어로 현재 프로젝트의 패키지 상태를 확인할 수 있습니다.

bash

ncu

이 명령어는 업데이트 가능한 패키지를 보여줍니다. -u 옵션을 추가하면 package.json 파일을 최신 버전으로 업데이트합니다.

bash

ncu -u

대화형 모드로 실행하려면 -i 옵션을 사용합니다.

이는 업데이트할 패키지를 선택할 수 있는 인터페이스를 제공합니다.

bash

ncu -i

package.json 파일이 업데이트된 후, 다음 명령어로 실제 패키지를 설치합니다.

bash

npm install

마무리

이 블로그에서는 npm 패키지 관리자를 최신 버전으로 업데이트하는 방법에 대해 알아보았습니다. 패키지 관리자를 최신 버전으로 유지하는 것은 프로젝트의 안정성과 보안성을 높이는 데 중요합니다.

그러나, 너무 자주 업데이트하는 것은 오히려 프로젝트에 문제를 일으킬 수 있으므로, 적절한 주기로 업데이트하는 것이 중요합니다.

주요 프레임워크나 라이브러리의 업데이트 내용을 공식문서에서 꼼꼼히 살펴보고, 변경된 내용이 프로젝트에 미치는 영향을 고려하는 것이 좋습니다.

맥북 홈 서버 만들기 (feat. Express Api)