nvm-sh 자주 묻는 질문 (FAQ)

Linux/macOS 버전

~/.bashrc 또는 ~/.zshrc에 추가:

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

NVM을 설치했지만 nvm 명령어가 작동하지 않습니다

이는 여러 가지 이유로 발생할 수 있습니다:

1. 환경 변수가 올바르게 설정되지 않음: NVM 디렉토리가 PATH에 추가되었는지 확인하세요
2. 터미널 재시작 필요: 설치 후 터미널이나 명령 프롬프트를 닫고 다시 열어보세요
3. 설정 파일이 업데이트되지 않음: bash 설정 파일(.bashrc, .bash_profile, .zshrc 등)에 NVM 초기화 코드가 포함되어 있는지 확인하세요

사용 문제

새 터미널을 열 때마다 Node.js 버전이 기본값으로 돌아갑니다

이는 NVM이 새 터미널 세션마다 기본 버전을 로드하기 때문입니다. 이 문제를 해결하려면:

1. Node.js의 기본 버전 설정:

   nvm alias default 14.17.0

2. 프로젝트 디렉토리에 .nvmrc 파일을 생성하고 프로젝트 디렉토리에서 nvm use 실행

Node.js 버전을 전환한 후 전역으로 설치된 패키지가 사라집니다

이는 NVM의 정상적인 동작입니다. 각 Node.js 버전은 자체적인 전역 패키지 세트를 가집니다. 버전을 전환하면 현재 버전에 설치된 전역 패키지에만 접근할 수 있습니다.

해결책은 다음과 같습니다:

1. 필요한 각 Node.js 버전에 전역 패키지를 별도로 설치
2. nvm reinstall-packages 명령어를 사용하여 한 버전에서 다른 버전으로 패키지 복사

nvm install 사용 시 SSL 오류

SSL 인증서 문제가 발생하는 경우 다음 방법을 시도해 보세요:

# Windows
nvm install 14.17.0 --insecure

# Linux/macOS
NVM_NODEJS_ORG_MIRROR=http://nodejs.org/dist nvm install 14.17.0

macOS에서 Node.js 버전 설치 중 오류

Node.js 모듈 컴파일 오류가 발생하고 있습니다. 이는 일반적으로 npm install 또는 yarn install을 실행할 때 발생합니다. 구체적인 오류 메시지:

# 오류:
/,nym/,cache/src/node-y14.18.0/files/out/Release/obj.target/v8 zlib/deps/v8/third party/zlib/zutil.o] Error 1
make[1]: *** [/Users/.../zutil.o] Error 1

이는 Node.js 모듈이 의존하는 V8 JavaScript 엔진용 zlib 라이브러리 컴파일에 실패했음을 나타냅니다.

해결책:

# Xcode Command Line Tools 설치
xcode-select --install

# Homebrew 설치 (설치되지 않은 경우)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Python 설치 (Python 3 권장)
brew install python

NVM을 제거하려면 어떻게 해야 하나요?

Linux/macOS

1. NVM 디렉토리 삭제: rm -rf "$NVM_DIR"
2. 쉘 설정 파일(.bashrc, .bash_profile, .zshrc 등)에서 NVM 관련 줄을 제거하세요. 자세한 내용은 설치 가이드를 참조하세요