nvm으로 Node.js 버전 관리하는 법 — 회사·사이드 프로젝트 충돌 해결한 방법 (윈도우)

7년 동안 프론트엔드 개발하면서 Node.js 버전 문제로 시간 날린 게 한두 번이 아니에요.

회사 프로젝트는 레거시라 구버전 Node가 필요하고, 사이드 프로젝트는 최신 기능 쓰고 싶어서 최신 버전 써야 하는데 — 매번 지웠다 깔았다 하다가 결국 nvm 도입했어요.

솔직히 진작 쓸걸 싶었어요. 설치하고 나서 버전 전환이 명령어 한 줄로 끝나거든요.

오늘은 윈도우 환경에서 nvm 설치하다가 제가 직접 겪은 에러들까지 포함해서 정리해볼게요. 이 글 하나로 따라 하면 막히는 곳 없이 끝낼 수 있어요.

---

nvm이 뭔데요?

nvm = Node Version Manager

Node.js 버전을 여러 개 설치해두고, 프로젝트마다 골라서 쓸 수 있게 해주는 도구예요.

예를 들면 이래요:

 

 

bash

# 회사 프로젝트 폴더에서
nvm use 16.20.0

# 사이드 프로젝트 폴더에서
nvm use 22.13.1

명령어 한 줄로 버전 전환 끝이에요. Node 재설치 필요 없어요.

맥에서는 기본 nvm을 쓰면 되는데, 윈도우는 별도 도구가 필요해요. nvm-windows라는 걸 써야 해요. 이름은 비슷한데 완전히 다른 프로젝트예요.

---

설치 전에 꼭 해야 할 것

기존 Node.js 완전히 삭제하기

nvm 설치 전에 기존에 깔린 Node.js를 먼저 지워야 해요. 안 지우면 버전 충돌 납니다.

윈도우 설정 → 앱 → Node.js 검색 → 제거

제거 후 아래 경로에 남은 폴더도 직접 삭제해주세요:

 

 

C:\Program Files\nodejs
C:\Users\[사용자명]\AppData\Roaming\npm
C:\Users\[사용자명]\AppData\Roaming\npm-cache

저는 이거 안 지우고 nvm 설치했다가 nvm use 해도 버전이 안 바뀌는 문제 겪었어요. 꼭 정리하고 시작하세요.

---

nvm-windows 설치

아래 링크에서 최신 릴리즈의 nvm-setup.exe 다운로드해요.

👉 https://github.com/coreybutler/nvm-windows/releases

💡 중요: 설치할 때 반드시 관리자 권한으로 실행하세요. 그냥 더블클릭하면 나중에 PATH 설정 꼬입니다.

설치 경로는 기본값 그대로 두는 게 안전해요. 한글 경로 있으면 에러 납니다.

---

설치 확인

설치 완료 후 새 cmd 창 열어서 확인해요. (기존 창 말고 새로 여세요. PATH 반영이 안 돼 있을 수 있어요.)

 

 

bash

nvm -v

버전 숫자가 뜨면 성공이에요.

⚠️ 여기서 'nvm'은 내부 또는 외부 명령... 에러 나면 → 관리자 권한으로 cmd 다시 열기

---

Node.js 설치하기

설치 가능한 버전 목록 확인:

 

bash

nvm list available

여기서 LTS 컬럼 중 가장 최신 버전 설치하면 돼요.

 

 

bash

nvm install 22.13.1

설치 후 사용할 버전 지정:

 

 

bash

nvm use 22.13.1

⚠️ 여기서 에러 자주 남: nvm use는 반드시 관리자 권한 cmd에서 실행해야 해요. 일반 권한이면 버전 전환이 안 돼요. 7년 동안 윈도우에서 개발하면서 이게 제일 많이 막히는 포인트예요.

확인:

 

 

bash

node -v   # v22.13.1 뜨면 성공
npm -v

---

자주 쓰는 nvm 명령어 모음

명령어설명

nvm list available	설치 가능한 버전 목록
nvm install [버전]	특정 버전 설치
nvm list	설치된 버전 목록
nvm use [버전]	사용할 버전 전환
nvm uninstall [버전]	특정 버전 삭제
nvm current	현재 사용 중인 버전 확인

---

제가 실제로 겪은 에러 3가지

① nvm use 해도 버전이 안 바뀜 → 기존 Node.js 폴더가 남아있어서 PATH가 꼬인 거예요. 위에서 말한 세 경로 폴더 삭제 후 재설치하면 해결돼요.

② nvm -v 했는데 명령어를 모른다고 함 → 관리자 권한으로 cmd 새로 열면 해결돼요. 설치 후 기존 창엔 PATH가 반영 안 돼 있어요.

③ 설치 경로에 한글/공백 있으면 에러 → 설치 경로 기본값 그대로 두세요. C:\Users\홍길동 이런 경로면 문제 생길 수 있어요. 이 경우엔 설치 경로를 C:\nvm으로 바꿔주면 돼요.

---

마무리

nvm 도입하고 나서 버전 때문에 시간 낭비하는 일이 완전히 없어졌어요.

회사 프로젝트 작업하다가 사이드 프로젝트로 넘어갈 때 nvm use 한 줄로 끝나니까요.

윈도우에서 막히는 포인트가 맥보다 많긴 한데, 이 글 순서대로 따라하면 한 번에 끝낼 수 있어요. 설치 전 기존 Node 완전 삭제 + 관리자 권한, 이 두 가지만 기억하세요.

다음 포스팅 예고: 회사 프로젝트와 사이드 프로젝트 Node 버전 자동 전환하는 법 — .nvmrc 설정

 

 

---