[Terminal] nvm 설치 방법 및 오류 해결 하기

Node.js 버전을 관리하기 위해 많이 사용하는 nvm(Node Version Manager)을 설치하려 했으나, 터미널에서 nvm 명령어를 찾을 수 없다는 메시지가 출력되는 경우가 있습니다. 이번 포스팅에서는 nvm 설치 방법과 문제 해결 방법에 대해서 알아봅시다.

nvm 이란?

nvm(Node Version Manager)**는 Node.js의 버전을 관리하기 위한 도구입니다.
프로젝트별로 다른 Node.js 버전이 필요할 때, 손쉽게 설치, 변경, 삭제할 수 있도록 도와줍니다.

 

nvm 주요 명령어

설치

nvm install <version>

 

사용

nvm use <version>

 

설치된 버전 확인

nvm ls

 

Node.js 버전 확인

node -v

 

오류 1 : Node.js 버전이 맞지 않을 때 경고 메시지 확인

yarn 또는 npm을 실행할 때 아래와 같은 오류 메시지가 출력될 수 있습니다

error The engine "node" is incompatible with this module. Expected version "20.x". Got "23.1.0".

 

1. 프로젝트의 Node.js 버전 요구 사항 확인

package.json 파일의 engines 필드에 명시된 Node.js 버전을 확인합니다

"engines": {
  "node": "v20"
}

 

2. 현재 사용 중인 Node.js 버전 확인

node -v

3. nvm으로 올바른 Node.js 버전 설치

프로젝트에서 요구하는 Node.js 버전을 설치합니다

nvm install v20

 

설치 후, 해당 버전을 사용하도록 전환합니다

nvm use v20

오류 2 : nvm 명령어를 찾을 수 없다는 메시지

zsh: command not found: nvm 또는 bash: nvm: command not found와 같은 메시지가 출력된다면, 아래 두 가지 중 하나의 문제일 가능성이 높습니다

• nvm이 설치되지 않음
• nvm이 설치되었으나, 쉘 환경 설정(~/.zshrc 또는 ~/.bashrc)에 제대로 연결되지 않음

 

nvm 버전 전환하기

 

nvm 버전 및 설치 확인하기

nvm 설치

macOS/Linux
nvm 설치는 공식 스크립트를 사용하는 것이 가장 간단합니다. 터미널에서 다음 명령을 실행하세요

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

 

쉘 재시작

1. 환경 설정 코드 추가

설치 후, 쉘 환경 파일(~/.zshrc, ~/.bashrc, 또는 ~/.bash_profile)에 아래 내용을 추가하세요

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

 

2. 환경 설정 적용

쉘 설정을 재적용하려면 아래 명령을 실행하세요

source ~/.zshrc

 

nvm 버전 및 설치 확인

nvm 버전 번호가 출력되면 설치가 완료된 것입니다.

nvm --version

 

nvm 설치 완료

nvm 특정 버전 사용

개발 환경에 따라 Node.js 버전을 사용해 보세요.

nvm 특정 버전 사용

 

 

 

nvm은 Node.js 버전을 관리하는 필수 도구로, 다양한 프로젝트에 적합한 개발 환경을 제공합니다. 위 단계를 따라 설치하고 문제를 해결해 보세요.

 

 

 

[Git] GitHub에서 Squash Merge로 프로젝트 히스토리 깔끔하게 정리하기

 

 

[CSS] 유튜브(Youtube) 영상을 비율 유지한 채 반응형으로 삽입하는 방법

 

[VSCode] 초보자를 위한 VSCode 단축키 가이드: 빠르고 효율적인 개발을 위해

 

[Webpack] webpack.config.js, 웹팩 주요 속성 5가지(entry/output/loader/plugins/mode)

 

[AI] 손필기는 이제 그만! 클로바 노트(CLOVA Note)의 음성 메모 혁신을 경험하세요!