macOS에서 Node.js를 설치하는 데 필요한 기본 정보와 설치 방법을 정리해 보았다.
Node.js 설치 전 개념 잡기
Node.js란?
브라우저를 벗어난 상황에서도 자바스크립트를 처리할 수 있도록 해 주는 실행 환경이다. 프론트엔드 개발도 가능하지만 백엔드, 즉, 서버 사이드에 강점을 보이는 것이 특징.
Node.js의 두 가지 버전
Node.js는 LTS 버전과 Current 버전이 있다. LTS(Long-Term Support) 버전은 문자 그대로 향후 장기적인 지원을 보장하는 안정된 버전을 말하며, Current 버전은 가장 최신 버전을 말한다.
NVM(Node Version Manager)이란?
Node.js를 사용하여 개발된 애플리케이션의 경우 사용된 버전에 대한 의존성이 있는 편이다. 특정 버전에서 잘 작동하는 앱이 다른 버전에서는 제대로 동작하지 않을 수도 있다는 말이다. 그래서 필요한 것이 바로 이 NVM이라는 툴인데, 각 Node.js 버전에 대한 개발 환경을 분리하여 관리할 수 있도록 해 준다.
NPM(Node Package Manager)이란?
Node.js를 기반으로 만들어진 오픈 소스 확장 라이브러리들이 많다. NPM은 이러한 패키지들을 관리하기 위한 툴이다. Node.js를 설치하면 NPM도 같이 설치되므로 의도된 것이 아니라면 굳이 별도의 설치 작업을 진행하지 않아도 된다.
Node.js 권장 설치 방법
설치 환경
아래 설명에서 사용된 예시는 다음의 설치 환경에서 진행된 것이다.
- M2 맥미니
- macOS Ventura 13.5
- zsh 쉘
Node.js의 공식 홈페이지를 살펴보면 터미널(패키지 매니저)을 통한 설치 방법, 인스톨러를 다운로드해서 설치하는 방법 등 여러 방법이 나오지만 여기서는 터미널을 통한 설치 방법만 정리하였다.
1. 터미널 실행 및 NVM 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
터미널을 열고 위와 같이 커맨드를 입력해 주면 NVM이 설치되는데, 주의할 것은 버전이다. 여기서는 v0.40.0을 사용하고 있지만 업데이트되었을 수도 있으므로 공식 홈페이지의 내용을 참고해서 바꿔 주는 것을 권장한다.
https://nodejs.org/en/download/package-manager
2. Node.js 설치
nvm install 20
NVM이 설치되었으면, 위 커맨드를 입력하여 Node.js를 설치한다. 마지막의 숫자는 버전이다. 현재 기준으로 LTS의 버전을 입력한 것이고, current 버전을 사용하고 싶다면 그에 맞는 숫자를 입력해 주면 된다.
3. 설치 확인
node -v
npm -v
설치가 완료되었으면 위 커맨드를 입력하여 제대로 설치되었는지 확인해 준다. 각각 Node.js의 버전, NPM의 버전을 확인하는 커맨드이다.
Node.js 비 권장 설치 방법
권장 설치 방법과 달리 NVM의 선제적인 설치 없이 Node.js만 설치하는 방법이다. 특정 Node.js 버전만 있으면 된다고 생각하는 개발자의 경우 이 방식으로 설치해도 무방하지만 설치 후 zsh 환경 변수를 편집해야 하는 등의 불편함이 뒤따른다.
1. 터미널 실행 및 Node.js 설치
brew install node
brew install node@20
터미널을 열고 위 커맨드를 입력하면 Node.js가 설치된다. 첫 번째는 current 버전을 설치하는 커맨드이고, 두 번째는 특정 LTS 버전을 설치하는 커맨드다. @기호 뒤의 숫자가 LTS 버전을 의미한다. 상황에 맞게 골라서 사용하자.
2. zsh 환경 변수 편집
1번을 완료하고 다음과 같이 커맨드를 입력해 보면 제대로 인식되지 않고 있다는 것을 알 수 있다.
이때 1번 과정 마지막 부분에 출력된 다음 메시지(빨간색 네모 표시)를 주목하자.
해당 내용을 zsh 쉘 환경 변수에 반영하라는 소리로 보인다. 시도는 해보지 않았다. 이 단계에서 권장 설치 방법을 알게 되었고, 기존 설치 내용은 brew uninstall 처리했다.