npm 업데이트 방법 · 명령 한 줄과 윈도우에서 주의할 점

지금 버전 확인

먼저 npm -v로 지금 쓰는 npm 버전을 확인합니다.

업데이트 전후로 한 번씩 확인하면 실제로 바뀌었는지 알 수 있습니다.

최신 버전으로 올리기

npm install -g npm@latest 명령으로 최신 안정 버전의 npm을 설치합니다.

-g는 프로젝트 하나가 아니라 컴퓨터 전체에서 쓰는 npm을 바꾼다는 뜻입니다.

실행 후 npm -v를 다시 입력해 숫자가 바뀌었는지 봅니다.

nvm을 쓰는 경우

nvm으로 Node.js를 관리한다면 Node.js 버전을 바꿀 때 npm 버전도 같이 바뀔 수 있습니다.

그래서 버전을 바꾼 뒤에는 npm -v로 다시 확인하는 습관을 들이면 헷갈릴 일이 줄어듭니다.

윈도우에서 숫자가 안 바뀔 때

윈도우에서 업데이트 명령을 실행했는데도 npm -v 숫자가 그대로라면, 위 버튼의 npm 공식 문서에 있는 윈도우 안내를 먼저 읽어 봅니다.

경로 설정이 꼬여 있으면 어떤 npm이 실행되는지부터 확인해야 하니, 무작정 명령을 반복하지 않는 편이 낫습니다.

주의할 점

권한 오류가 난다고 무조건 관리자 권한으로 실행하기보다, 원인을 먼저 확인하는 편이 안전합니다. 버전 관리 도구를 쓰면 권한 문제가 줄어듭니다.

회사 프로젝트라면 팀이 쓰는 npm 버전을 맞춰 두는 것이 좋습니다. 혼자만 올리면 잠금 파일이 다르게 만들어질 수 있습니다.

npm 업데이트와 패키지 업데이트는 다른 일입니다. 패키지 보안 점검은 npm audit으로 따로 합니다.

CI(자동 빌드) 환경을 쓴다면 빌드 서버의 npm 버전도 함께 확인합니다. 내 컴퓨터만 올리고 빌드 서버는 그대로 두면 결과가 달라질 수 있습니다.

업데이트 명령을 실행하기 전에 지금 버전을 메모해 두면, 문제가 생겼을 때 어느 버전으로 되돌릴지 바로 알 수 있습니다.

자주 묻는 질문

Q. npm update -g npm으로 해도 되나요?

공식 문서에 나온 명령은 npm install -g npm@latest입니다. 공식 문서 명령을 쓰는 편이 헷갈림이 적습니다.

Q. 업데이트 후 프로젝트가 안 돌아가요.

npm 버전 변화로 생기는 일일 수 있으니, 팀이 쓰던 버전으로 되돌려 시험해 보세요.

Q. 얼마나 자주 올려야 하나요?

보안 수리가 들어간 버전이 나오면 올리고, 평소에는 Node.js를 업데이트할 때 함께 확인하는 정도로 충분합니다.