NVM으로 Node.js 버전 바꾸기
개인 노트북에서 급하게 업무를 보게 되었는데 작업을 해야 할 프로젝트 환경은 Node 16버전에 맞춰져 있었고 개인 환경은 현재 Node LTS 버전인 20버전을 사용하다 보니 packge dependency 설치에 오류가 발생했습니다.
그래서 NVM에 대해 찾아보고 설치하여 맞는 Node 버전으로 스위칭하여 업무를 할 수 있었습니다. 이번 기회에 간단하게 NVM에 대해 알아보겠습니다.
NVM?
NVM은 Node Version Manager로 command line을 통해 원하는 Node 버전으로 설치할 수 있습니다. 또한 설치된 Node 버전에 따라 npm 버전도 따라서 설치됩니다.
NVM 설치 및 적용
Window에서 설치 방법
해당 nvm-widows github에서 nvm-setup.exe을 다운로드 후 설치를 진행합니다.
Mac에서 설치 방법
아래 command line으로 nvm을 설치합니다.
# nvm 설치
sudo curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.39.7/install.sh | bash
# 설치 후 설치 확인을 위한 nvm 명령어(nvm으로 설치된 node 버전 확인) 입력
nvm ls
※ bash 쉘 기준에서 해당 오류가 뜬다면? ⇒ -bash: nvm: command not found
# bash_profile vi 에디터 접근
vi ~/.bash_profile
# vi 에디터에서 해당 코드가 없을 경우 추가 후 저장
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm
#
source ~/.bash_profile
# 재확인
nvm ls
※ zsh 쉘 기준에서 해당 오류가 뜬다면? ⇒ zsh: command not found: nvm
# zshrc vi 에디터 접근
vi ~/.zshrc
# vi 에디터에서 해당 코드가 없을 경우 추가 후 저장
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
#
source ~/.zshrc
# 재확인
nvm ls
설치 및 설정이 완료되었다면 아래와 같이 확인할 수 있습니다.
-> system
node -> stable (-> N/A) (default)
iojs -> N/A (default)
설치 관련하여 nvm github에서 자세하게 확인할 수 있습니다.
Node 버전 적용
원하는 Node 버전으로 설치하기 위해 해당 명령어를 통해 실행합니다.
# nvm install <설치할 Node 버전>
% nvm install 16
Now using node v16.20.2 (npm v8.19.4)
% node -v
v16.20.2
# 특정 버전 Node 설치
% nvm install 18.12.0
Now using node v18.12.0 (npm v8.19.2)
% node -v
v18.12.0
# nvm use <사용할 Node 버전>
% nvm use 16
Now using node v16.20.0 (npm v8.19.4)
% node -v
v16.20.0
% nvm use 20
Now using node v20.11.1 (npm v10.2.4)
% node -v
v20.11.1
메이저 버전만 명시할 경우 메이저 버전의 LTS 버전으로 설치됩니다. 명령어 관련 내용도 nvm github에서 자세하게 확인할 수 있습니다.
마무리
따로 개발 환경이 셋팅된 VM이나 도커에서 개발을 진행하면 호스트의 Node 버전에 영향이 없어서 상관이 없겠지만 그렇지 못할 경우 NVM을 이용하면 원하는 Node와 npm 버전으로 쉽게 셋팅할 수 있어서 좋았습니다. Node 버전을 바꿔야 하는 상황이 있다면 NVM을 이용해 보는 것도 좋겠습니다.
참고 자료
https://gist.github.com/falsy/8aa42ae311a9adb50e2ca7d8702c9af1