노드 버전 관리자를 mise로 변경하기

노드 버전 관리는 왜 필요할까?

nodejs의 현재 lts 버전은 24.14.1이다. 매해 새로운 버전들이 나오고 진행하는 프로젝트마다 사용하는 nodejs의 버전이 달라지게 되는데 그때 마다 새로 설치할 수는 없으니 노드 버전 관리 도구들이 나왔다.
아마 가장 많이 사용하는 노드 버전 관리 도구는 nvm일 것이다. 가장 초기에 나왔고 nvm이라는 이름 자체가 node version manager에서 앞글자만 딴 것이기 때문에 가장 익숙한 이름이기도 하기 때문이다.
nvm의 단점은 크로스 플랫폼을 지원하지 않는 다는 점이다. nvm-windows가 있지만 nvm 자체가 아니고 기능들이 몇개 빠져있는 별도의 패키지이다.

nvm 삭제하기

vi ~/.zshrc

위의 명령어를 입력하면 zsh 터미널의 설정 파일을 확인할 수 있다.

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

파일 내부에서 위와 같이 nvm 설정이 나와 있는 부분을 확인 할 수 있는데 이 부분을 지우면 된다.
vi 에디터는 영어로 i를 누르면 insert 모드가 된다. insert 모드로 변경 후 삭제하고 esc를 눌러 insert 모드를 종료하자. 그리고 :wq를 입력하면 저장하고 종료가 된다.

rm -rf ~./nvm

위 의 명령어로 nvm 설정들까지 다 지운 후에 터미널을 종료 후 다시 실행하자.

mise 설치하기

크로스 플랫폼을 지원하는 노드 관리 도구 중에서 volta를 사용하려고 했지만 현재는 유지보수 되고 있지 않기 때문에 volta에서 추천하는 mise를 설치 해보도록 하자.

curl https://mise.run | sh

위의 명령어로 mise를 설치할 수 있다.

~/.local/bin/mise --version

#              _                                        __              
#  ____ ___  (_)_______        ___  ____        ____  / /___ _________
#  / __ `__ \/ / ___/ _ \______/ _ \/ __ \______/ __ \/ / __ `/ ___/ _ \
#/ / / / / / (__  )  __/_____/  __/ / / /_____/ /_/ / / /_/ / /__/  __/
#/_/ /_/ /_/_/____/\___/      \___/_/ /_/     / .___/_/\__,_/\___/\___/
#                                            /_/                 by @jdx

제대로 설치되어 있는 지를 확인하려면 --version flag를 사용해 버전이 제대로 나오는 지 확인을 해보면 된다.
mise는 로컬에 설치되는데 mise로 사용하려면 활성화시켜줘야 한다.

echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc

위의 명령어를 실행하면 mise로도 커맨드를 입력할 수 있고, 추가된 부분은 ~/.zshrc에서 확인할 수 있다.

node 설치하기

# 글로벌 설치
mise use --global node@24

--global flag를 통해서 글로벌로 설치할 수 있고, 프로젝트에 필요한 nodejs 버전을 파악해서 자동으로 버전을 변경해준다. 해당 버전에 맞는 설치나 프로젝트에 버전을 설정(mise.toml)할 때도 그냥 use를 사용하면 된다.