TechFeedTechFeed
개발자 작업환경

npm 업데이트 | 맥은 명령 하나, 윈도우는 PATH 순서까지 봅니다

npm 업데이트 명령은 npm install -g npm@latest. 윈도우에서 npm -v가 그대로면 PATH에서 nodejs 폴더가 사용자 전역 폴더보다 앞에 있는 상황입니다. 근거는 npm 공식 문서입니다.

by

npm 업데이트는 터미널에서 npm install -g npm@latest를 실행하면 끝납니다. 다만 윈도우에서는 명령이 성공했는데도 npm -v 숫자가 그대로인 일이 자주 생깁니다. 원인은 PATH 순서입니다. Node.js 설치 프로그램이 넣은 nodejs 폴더가 사용자 전역 폴더보다 먼저 검색되어, 새로 받은 npm 대신 Node.js에 딸려 온 npm이 실행됩니다. 윈도우에서는 PATH 순서를 바꾸거나, nodejs 폴더의 npm 파일을 지우거나, 그 폴더 안에서 직접 업데이트하는 세 방법 가운데 하나를 고르면 됩니다. nvm이나 mise를 쓴다면 Node.js 버전마다 npm이 따로 있으니 전환할 때마다 버전을 확인하세요. 명령은 모두 2026년 10월 28일에 연 npm 공식 문서에 적힌 그대로입니다.


npm 업데이트 요약
업데이트 명령
npm install -g npm@latest
버전 확인
npm -v
윈도우에서 안 바뀌면
PATH 순서 확인
전역 경로 확인
npm config get prefix -g

npm을 최신 버전으로 올리는 명령은 무엇인가요?

바로 답 | npm install -g npm@latest입니다. 실행 뒤 npm -v로 숫자가 바뀌었는지 확인하세요.


npm 업데이트와 확인 (npm 공식 문서 명령)
npm -v npm install -g npm@latest npm -v

npm 공식 문서 "Try the latest stable version of npm"은 최신 안정 버전으로 올리는 방법으로 위 명령을 안내합니다. @latest는 npm 레지스트리에서 latest 태그가 붙은 버전을 뜻하므로, 특정 메이저를 고정하고 싶다면 npm@10처럼 버전을 직접 적으면 됩니다.


맥이나 리눅스에서 Node.js를 공식 설치 프로그램으로 넣었다면 전역 폴더가 시스템 경로에 있어 권한 오류(EACCES)가 날 수 있습니다. 이때 습관처럼 sudo를 붙이기보다 전역 설치 경로를 사용자 폴더로 옮기거나 nvm 같은 버전 관리 도구로 Node.js를 다시 설치하는 방법을 먼저 검토하세요. npm 문서도 권한 오류를 피하는 방법으로 Node 버전 관리자 사용을 권장합니다.


윈도우에서 업데이트했는데 npm -v가 그대로라면?

바로 답 | PATH에서 %ProgramFiles%\nodejs가 %AppData%\npm보다 앞에 있어 예전 npm이 먼저 실행되는 상황입니다.


npm 문서 설명에 따르면 Node.js 윈도우 설치 프로그램은 PATH에 %ProgramFiles%\nodejs를 사용자 전역 폴더 %AppData%\npm보다 앞에 넣습니다. npm install -g npm@latest는 새 npm을 %AppData%\npm에 설치하지만, cmd 창은 PATH 앞쪽의 nodejs 폴더에서 npm을 먼저 찾기 때문에 Node.js와 함께 깔린 예전 버전이 실행됩니다.


먼저 전역 설치 위치를 확인하세요. 아래 명령 결과가 %AppData%\npm 경로라면 새 npm은 그곳에 들어갔고, 실행 순서만 바꾸면 됩니다.


윈도우 cmd 창에서 확인
npm config get prefix -g where npm
방법하는 일주의할 점
1. PATH 순서 바꾸기시스템 환경 변수에서 %AppData%\npm을 %ProgramFiles%\nodejs 앞으로 옮깁니다.열려 있는 터미널은 다시 열어야 반영됩니다.
2. nodejs 폴더의 npm 파일 지우기%ProgramFiles%\nodejs 안의 npm, npm.cmd 파일을 지웁니다.Node.js를 다시 설치하거나 업데이트하면 파일이 돌아올 수 있습니다.
3. nodejs 폴더 안에서 업데이트관리자 권한 cmd 창으로 %ProgramFiles%\nodejs에 들어가 npm install npm@latest를 실행합니다.이 명령에는 -g를 붙이지 않습니다.

세 방법 모두 npm 공식 문서가 제시한 선택지입니다. 회사 PC처럼 시스템 환경 변수를 바꿀 권한이 없다면 3번이 현실적이고, 개인 PC라면 1번이 이후 업데이트까지 깔끔하게 유지됩니다.


nvm이나 mise로 Node.js를 쓰면 무엇이 달라지나요?

바로 답 | npm은 Node.js 버전마다 따로 설치되므로, 지금 쓰는 Node.js 버전 안에서 업데이트한 npm만 바뀝니다.


nvm, mise 같은 도구는 Node.js 버전마다 별도 폴더를 만들고 그 안에 npm을 함께 넣습니다. 그래서 Node.js 24에서 npm을 올려도 Node.js 22로 전환하면 22에 딸린 npm 버전이 다시 보입니다. 이 경우 PATH 문제를 따로 고칠 필요는 거의 없고, 버전을 바꿀 때마다 npm -v를 한 번 확인하는 습관이면 충분합니다.


팀 프로젝트에서 npm 메이저 버전이 바뀌면 package-lock.json 형식이나 설치 결과가 달라질 수 있습니다. 혼자 최신으로 올리기 전에 CI와 동료가 쓰는 버전을 맞춰 두세요. Node.js 버전을 프로젝트별로 고정하는 방법은 mise, nvm, pyenv 도구 버전 고정에서 다뤘습니다.


이런 분께 맞아요
개인 윈도우 PC
PATH 순서를 바꾸는 1번이 이후 업데이트까지 그대로 유지됩니다.
환경 변수 권한이 없는 회사 PC
관리자 권한으로 nodejs 폴더 안에서 업데이트하는 3번을 쓰세요.
nvm, mise 사용자
PATH는 그대로 두고 Node.js 버전마다 npm -v를 확인하면 됩니다.

업데이트 전후에 확인할 것은 무엇인가요?

바로 답 | 현재 버전, 전역 설치 위치, 프로젝트가 요구하는 npm 버전 세 가지를 보면 됩니다.


npm 업데이트 체크리스트
  • ☑npm -v와 node -v로 지금 버전을 적어 두었나요?
  • ☑npm config get prefix -g로 전역 설치 위치를 확인했나요?
  • ☑package.json의 engines나 packageManager에 npm 버전이 적혀 있지 않나요?
  • ☑윈도우라면 업데이트 뒤 터미널을 새로 열고 where npm 첫 결과를 확인했나요?
  • ☑CI 설정의 Node.js 버전과 로컬 버전이 같은 메이저인가요?

npm 업데이트, 자주 묻는 질문

Node.js를 업데이트하면 npm도 같이 올라가나요?

Node.js 설치 파일에는 그 버전에 맞춘 npm이 들어 있어서, Node.js를 새로 설치하면 함께 들어온 npm 버전으로 바뀝니다. 다만 그 npm이 latest 태그 버전과 같다는 보장은 없으니 필요하면 npm install -g npm@latest를 따로 실행하세요.


npm update 명령으로 npm 자체도 올라가나요?

npm update는 프로젝트 의존성을 범위 안에서 갱신하는 명령입니다. npm 자체를 최신으로 올릴 때는 공식 문서대로 npm install -g npm@latest를 쓰세요.


업데이트 후 문제가 생기면 이전 버전으로 돌아갈 수 있나요?

버전을 직접 지정해 다시 설치하면 됩니다. 예를 들어 npm install -g npm@10처럼 메이저 버전을 적으면 그 메이저의 최신 버전이 설치됩니다.


출처: npm Docs, Try the latest stable version of npm, npm Docs, Resolving EACCES permissions errors (2026년 10월 28일 확인). 관련 글: Node.js 설치 방법, Node.js LTS 버전 고르기.


npmnpm 업데이트Node.js윈도우 PATHnpm@latest

함께 보면 좋은 문제 해결

EXPLORE / 개발자 작업환경

이어서 읽어보기

전체 토픽 둘러보기 →