Mac에서 NVM을 이용한 Node.js 설치 가이드

Node.js 개발을 시작하려면 버전 관리가 중요합니다. 특히 여러 프로젝트를 동시에 진행할 때 프로젝트마다 다른 Node.js 버전이 필요할 수 있습니다. NVM(Node Version Manager)은 이러한 상황에서 큰 도움이 됩니다. 이 글에서는 Mac에서 NVM을 설치하고 이를 통해 Node.js를 관리하는 방법을 상세히 알아보겠습니다.

NVM이란?

NVM은 Node Version Manager의 약자로, 여러 버전의 Node.js를 쉽게 설치하고 전환할 수 있게 해주는 도구입니다. 이를 통해 프로젝트별로 필요한 Node.js 버전을 독립적으로 사용할 수 있어 호환성 문제를 효과적으로 해결할 수 있습니다.

준비 사항

Mac에서 NVM을 설치하기 전에 다음 도구들이 필요합니다:

1. 터미널 애플리케이션: Mac에 기본으로 설치되어 있습니다.
2. Homebrew(권장): Mac용 패키지 관리자입니다. 설치되어 있지 않다면 설치를 권장합니다.
3. Git: 대부분의 Mac에는 기본으로 설치되어 있습니다.

1단계: Homebrew 설치 (선택 사항)

Homebrew가 설치되어 있지 않다면, 터미널에서 다음 명령어를 실행합니다:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치가 완료되면 다음 명령어로 정상 설치 여부를 확인합니다:

brew --version

2단계: NVM 설치하기

NVM을 설치하는 방법은 크게 두 가지가 있습니다: curl이나 wget을 이용한 스크립트 설치, 그리고 Homebrew를 이용한 설치입니다.

방법 1: curl을 이용한 설치 (권장)

터미널에서 다음 명령어를 실행합니다:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

만약 wget이 설치되어 있다면 다음 명령어도 사용 가능합니다:

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

이 스크립트는 NVM을 ~/.nvm 디렉토리에 클론하고, 사용자의 프로필 파일(.bash_profile, .zshrc, .profile 또는 .bashrc)에 필요한 설정을 추가합니다.

방법 2: Homebrew를 이용한 설치

Homebrew가 설치되어 있다면 다음 명령어를 통해 NVM을 설치할 수 있습니다:

brew install nvm

Homebrew로 설치한 경우 추가 설정이 필요합니다. Homebrew가 안내하는 지시에 따라 ~/.zshrc, ~/.bash_profile 또는 사용 중인 쉘의 프로필 파일에 다음과 같은 내용을 추가해야 합니다:

export NVM_DIR="$HOME/.nvm"
[ -s "$(brew --prefix)/opt/nvm/nvm.sh" ] && \. "$(brew --prefix)/opt/nvm/nvm.sh"
[ -s "$(brew --prefix)/opt/nvm/etc/bash_completion.d/nvm" ] && \. "$(brew --prefix)/opt/nvm/etc/bash_completion.d/nvm"

3단계: 쉘 프로필 파일 적용하기

NVM 설치 후, 변경된 환경 설정을 적용하기 위해 다음 명령어 중 하나를 실행합니다:

Bash를 사용하는 경우:

source ~/.bash_profile

Zsh를 사용하는 경우(macOS Catalina 이상에서 기본값):

source ~/.zshrc

또는 간단히 터미널을 닫고 다시 열어도 됩니다.

4단계: NVM 설치 확인

NVM이 올바르게 설치되었는지 확인하기 위해 다음 명령어를 실행합니다:

nvm --version

버전 번호가 출력되면 NVM이 정상적으로 설치된 것입니다.

5단계: Node.js 설치하기

이제 NVM을 사용하여 Node.js를 설치할 수 있습니다.

최신 버전 설치

최신 안정 버전의 Node.js를 설치하려면 다음 명령어를 실행합니다:

nvm install node

특정 버전 설치

특정 버전의 Node.js를 설치하려면 버전 번호를 지정하면 됩니다:

nvm install 14.17.0

LTS(장기 지원) 버전 설치

LTS(Long Term Support) 버전을 설치하려면 다음 명령어를 사용합니다:

nvm install --lts

6단계: Node.js 버전 사용하기

설치한 Node.js 버전을 사용하기 위해 다음 명령어를 실행합니다:

특정 버전 사용

nvm use 14.17.0

최신 버전 사용

nvm use node

LTS 버전 사용

nvm use --lts

7단계: 기본 Node.js 버전 설정

시스템 전체에서 기본적으로 사용할 Node.js 버전을 설정하려면 다음 명령어를 사용합니다:

nvm alias default 14.17.0

또는 최신 LTS 버전을 기본값으로 설정:

nvm alias default lts/*

8단계: 설치된 Node.js 버전 확인

현재 설치된 모든 Node.js 버전을 확인하려면 다음 명령어를 사용합니다:

nvm ls

사용 가능한 모든 Node.js 버전을 확인하려면:

nvm ls-remote

9단계: npm 사용하기

Node.js가 설치되면 npm(Node Package Manager)도 함께 설치됩니다. npm이 정상적으로 설치되었는지 확인하려면:

npm --version

추가 팁: 프로젝트별 Node.js 버전 설정

특정 프로젝트 디렉토리에서 자동으로 사용할 Node.js 버전을 설정하려면, 프로젝트 루트 디렉토리에 .nvmrc 파일을 생성하고 원하는 Node.js 버전을 작성합니다:

echo "14.17.0" > .nvmrc

이후 해당 디렉토리에서 다음 명령어만 실행하면 .nvmrc에 지정된 버전을 자동으로 사용합니다:

nvm use

문제 해결

1. nvm: command not found 오류

이 오류가 발생하면 NVM이 제대로 설치되지 않았거나 환경 변수가 올바르게 설정되지 않은 것입니다. 다음을 확인해보세요:

1. NVM이 설치된 경로가 올바른지 확인합니다.
2. 쉘 프로필 파일(.bash_profile, .zshrc 등)에 NVM 관련 설정이 추가되었는지 확인합니다.
3. 터미널을 다시 시작하거나 프로필 파일을 다시 로드합니다.

2. 특정 버전의 Node.js 설치 실패

인터넷 연결이 불안정하거나 권한 문제로 인해 설치가 실패할 수 있습니다. 다음을 시도해 보세요:

1. 다시 설치 명령을 실행합니다.
2. 관리자 권한으로 시도합니다.
3. 프록시 설정을 확인합니다.