M1 맥북 NVM 설치 안내

Windows OS vs Mac OS

윈도우 환경에서 Node.js 설치는 https://nodejs.org 접속 후 필요한 버전을 찾아 다운로드 설치를 진행하는 방식으로 그 방법이 간단하지만, Mac 환경에서는 유닉스 기반으로 만든 OS로 개발환경 설치를 터미널과 터미널 명령어로 설치해야 하는 차이가 있다.

윈도우에 익숙했기에 Mac 환경으로 개발환경을 변경하면서 생소한 Node.js 설치방법에 혼란이 있었고, 또 다시 Node.js 재설치 진행시 불필요한 시간 낭비룰 줄이기 위해 모든 과정을 기록으로 남겨본다.

다만, 이 내용은 개인적인 환경 특성에 맞춘 설치 매뉴얼이라는 점에서 각자 상황에 따라 정상적으로 Node.js가 실행이 안 될 수 있음을 참고 바란다.

---

Intel vs M1

인텔 칩을 사용하는 구형 맥북에서는 LTS 또는 최신 버전의 Node.js 설치해도 무관하지만, M1 칩 사용하는 최신 맥북에서는 Node v14 이하 환경에서만 NPM이 사용가능하다고 한다. OS 업데이트 후 개선되었다는 내용도 있지만 안정성으로 위해 Node v14 설치하기로 했다.

맥북에서 Node.js의 하위버전 설치를 하기 위해서는 NVM 설치가 필요하다.

---

NVM 장점

• Node Version Manaer
• Node.js 의 버전을 관리하는 도구로
• 컴퓨터에 다양한 버전의 Node.js 를 설치 후 터미널 명령어를 통해 Node.js 버전을 스위치(switch) 가능함
• 다양한 프로젝트 진행시 라이브러리/프레임워크/개발툴 버전 호환성 문제 해결에 용의함

---

개발환경설정

1. homebrew 설치

• MacOS 전용 패키지 관리 도구로 터미널을 통해서 명령어를 실행한다.
• 개발환경 관리 도구에 표준으로 인식되고 있다.
• 설치 방법은 https://brew.sh/ 접속 후 설치명령어를 복사하여 터미널에서 실행한다.

설치명령어 복사 후 터미널 실행

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

관리자 권한

sudo(관리자권한)으로 설치가 진행되므로, 맥북 계정 Password를 입력해야되며, 입력 후 설치가 진행이 된다.
인터넷 환경에 따라 설치 시간이 꽤 소요될 수 있다.

정상 설치 확인

설치가 끝나고 which brew와 brew --version 명령어를 터미널에 입력하여 정상 여부를 확인 할 수 있다.

$me2designer@ui-MacBookAir ~ % brew --version
Homebrew 3.5.2

---

2. NVM 설치

brew 사용한 nvm 설치

$ brew install nvm

nvm이 사용할 디렉토리를 생성

$ mkdir ~/.nvm

터미널 명령어
mkdir = 폴더생성
~/ = 내 계정의 최상위 root(위치)
.nvm = 생성할 폴더 이름

환경변수 설정하기

vi 편집기를 이용해 ~/.zshrc로 들어간다.

$ vi ~/.zshrc

vi 편집기는 터미널을 사용 문서 편집 방식으로 아래 코드를 복사, 붙여넣기 한다.
그 후 ESC 키 누르고, :wq (Write Quit) 입력하시고 enter 입력하면 vi 편집모드가 종료된다.

export NVM_DIR=~/.nvm
source $(brew --prefix nvm)/nvm.sh

정상 설치 확인

nvm --version 명령어를 사용하여 설치 상태를 확인한다.

아래처럼 나오면 정상

$ me2designer@ui-MacBookAir ~ % nvm --version
0.39.1

아래처럼 나오면 오류이다.

$ me2designer@ui-MacBookAir ~ % nvm --version
zsh: command not found: nvm

오류 발생된다면
만약 오류가 나오면 nvm 경로 설정 문제거나,
nvm 및 homebrew 모두 삭제 후 처음부터 다시 진행해야 해결되는 경우도 있다.
m1 맥북에서 처음 세팅하면서 이 문제로 하루종일 고생했고,
파일삭제와 환경 변수를 여러 방법으로 변경 후 결국 해결 할 수 있었다.

---

3. nodejs 설치

nvm 설치 방법은 nvm install [node.js 버전]을 입력하면 된다.

 $ nvm install v14

정상 설치 확인

 $ me2designer@ui-MacBookAir ~ % node --version
 v14.19.3