Node.js는 JavaScript 런타임으로, 다양한 프로젝트에서 사용됩니다. 하지만 프로젝트마다 요구하는 Node.js 버전이 다를 수 있기 때문에 여러 버전을 설치하고 관리할 필요가 있습니다. 이를 효율적으로 도와주는 도구가 바로 NVM(Node Version Manager)입니다. 이 글에서는 Mac 환경에서 NVM을 설치하고 사용하는 방법을 친절히 안내하겠습니다.
1. NVM이란?
NVM(Node Version Manager)은 여러 Node.js 버전을 쉽게 설치하고 관리할 수 있는 커맨드라인 도구입니다.
- 프로젝트마다 다른 Node.js 버전을 사용할 수 있습니다.
- 새로운 Node.js 버전을 간단히 설치하고, 필요 없는 버전은 삭제할 수 있습니다.
2. NVM 설치하기
2.1 Homebrew를 사용해 설치하기
Mac에서는 Homebrew를 통해 NVM을 간단히 설치할 수 있습니다. Homebrew가 설치되어 있지 않다면 먼저 Homebrew 공식 웹사이트의 설치 명령어를 따라 설치하세요.
설치 명령어:
brew install nvm
2.2 설치 후 설정하기
NVM을 설치한 후에는 셸 환경 설정 파일에 NVM 경로를 추가해야 합니다.
1. 사용 중인 셸 확인
- 기본적으로 Mac에서는 zsh가 기본 셸입니다. 하지만 bash를 사용하는 경우도 있습니다.
echo $SHELL
2. zsh의 경우 설정 파일 수정하기
export NVM_DIR="$HOME/.nvm"
echo '[ -s "/usr/local/opt/nvm/nvm.sh" ] && . "/usr/local/opt/nvm/nvm.sh"' >> ~/.zshrc
echo '[ -s "/usr/local/opt/nvm/etc/bash_completion" ] && . "/usr/local/opt/nvm/etc/bash_completion"' >> ~/.zshrc3. 설정 반영
source ~/.zshrc
2.3 설치 확인하기
NVM이 제대로 설치되었는지 확인하려면 다음 명령어를 실행하세요.
nvm --version
3. NVM으로 Node.js 설치 및 관리하기
3.1 Node.js 설치
NVM을 사용하면 특정 버전의 Node.js를 설치할 수 있습니다.
최신 LTS 버전 설치
nvm install --lts
특정 버전 설치
nvm install 16.20.0 # 원하는 버전 입력
3.2 설치된 Node.js 버전 확인
nvm list
3.3 Node.js 버전 전환
- 특정 버전 사용:
nvm use 16.20.0
- 기본 버전 설정:
nvm alias default 16.20.0
3.4 사용하지 않는 버전 삭제
nvm uninstall 14.18.1 # 삭제할 버전 입력
4. 프로젝트별 Node.js 버전 관리하기
NVM을 사용하면 프로젝트마다 다른 Node.js 버전을 사용할 수 있습니다. 프로젝트 디렉토리 안에 .nvmrc 파일을 생성하고 원하는 버전을 입력하세요.
.nvmrc 파일 생성:
cd /path/to/your/project
echo "16.20.0" > .nvmrc
프로젝트 디렉토리로 이동 시 자동으로 해당 버전 사용:
nvm use
5. 자주 사용하는 명령어 요약
| 명령어 | 설명 |
| nvm install <version> | 특정 버전의 Node.js 설치 |
| nvm install --lts | 최신 LTS 버전 설치 |
| nvm use <version> | 특정 Node.js 버전 사용 |
| nvm alias default <version> | 기본 Node.js 버전 설정 |
| nvm list | 설치된 Node.js 버전 목록 확인 |
| nvm uninstall <version> | 특정 Node.js 버전 삭제 |
6. 문제 해결하기
6.1 NVM 명령어가 인식되지 않을 때
- 설정 파일(~/.zshrc 또는 ~/.bashrc)에 추가한 경로가 정확한지 확인하세요.
- 설정 파일을 다시 로드하세요:
source ~/.zshrc
6.2 권한 관련 오류 발생 시
- Node.js 글로벌 패키지 설치 시 권한 문제가 발생할 수 있습니다. 이를 해결하려면 NVM으로 관리되는 Node.js를 사용 중인지 확인하고, 필요 시 nvm use 명령어로 버전을 활성화하세요.
프로젝트마다 필요한 Node.js 버전을 손쉽게 전환하며 개발 환경을 최적화하세요.
NVM은 특히 다양한 버전의 Node.js를 요구하는 프로젝트를 다룰 때 매우 유용한 도구입니다. 이제 더 이상 Node.js 버전 충돌로 고민하지 않아도 됩니다!
댓글