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

NVM 설치 시 흔한 문제와 해결책. NVM(Node Version Manager)은 Node.js 버전을 관리하기 위한 도구이지만, 설치 및 사용 중에 몇 가지 문제가 발생할 수 있습니다. 이 글에서는 NVM 설치 시 자주 발생하는 문제들을 요약하고 자세한 해결책을 제공합니다.

일반적인 문제

1. nvm을 설치하기 전에 Node.js를 제거하지 않아 nvm 설치 후 node와 npm을 사용할 수 없게 됨.
1. nvm으로 Node.js를 처음 설치한 후, nvm use로 Node.js 버전을 전환하고 nvm on으로 Node.js 버전 관리를 활성화해야 합니다. 그렇지 않으면 node와 npm을 사용할 수 없습니다.
1. npm을 전역적으로 설치한 후, cnpm을 설치하기 전에 터미널 창을 닫고 다시 열어야 합니다.
1. nvm의 설치 폴더를 선택할 때, 중국어 문자나 공백이 포함된 폴더 이름은 피하세요.

PowerShell에서 NVM 명령어가 인식되지 않음

기본적으로 NVM 명령어는 명령 프롬프트(CMD)에서만 사용할 수 있으며 PowerShell에서는 직접 인식되지 않습니다. 이는 PowerShell의 실행 정책이 스크립트 실행을 제한하기 때문입니다.

문제 설명:

PowerShell에서 nvm 명령어를 입력하면 "명령어가 인식되지 않음"이 표시됩니다.

해결책:

현재 실행 정책 확인:

PowerShell에서 다음 명령어를 입력하여 현재 사용자의 실행 정책을 확인합니다

powershell

Get-ExecutionPolicy -List

실행 정책 변경: 현재 사용자의 실행 정책을 RemoteSigned로 변경하여 로컬 스크립트 실행을 허용합니다:

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

작동 확인: PowerShell을 다시 열고 nvm 명령어를 실행하여 작동하는지 확인합니다.

Node.js 설치 후 오류

nvm을 설치한 후, 특정 Node.js 버전을 사용할 수 없고 오류가 발생하면 npm 명령어도 사용할 수 없을 수 있습니다. 이는 다운로드 과정에서 Node.js는 설치되었지만 npm 설치에 실패했을 가능성이 있습니다.

해결책:

Node.js 공식 웹사이트에서 직접 Node.js 압축 패키지를 다운로드합니다.
Node.js 버전을 제거하고 다시 설치합니다. 즉, nvm uninstall xxxx를 실행한 다음 nvm install xxx를 다시 실행합니다.
다른 Node.js 버전 설치를 시도합니다.

nvm use가 작동하지 않음

nvm 디렉토리에 node.js 폴더를 생성합니다. (참고: nvm 폴더와 nodejs 폴더의 속성을 수정하여 "속성 -> 보안" 탭에서 전체 제어 권한을 설정해야 합니다)

node -v가 작동하지 않는 문제

환경 변수의 경로 매개변수를 수정하여 NVM_SYMLINK가 새로 생성된 node.js 경로를 가리키도록 합니다. (아래 이미지와 같이 위아래 2곳이 있습니다)

NVM과 Node.js 직접 설치의 차이점은 무엇인가요?

NVM을 사용하면 동일한 시스템에서 여러 Node.js 버전을 설치하고 관리할 수 있지만, Node.js를 직접 설치하면 한 버전만 사용할 수 있습니다. NVM을 사용하면 다양한 버전 간에 쉽게 전환할 수 있어 호환성 테스트나 특정 Node.js 버전이 필요한 프로젝트 작업에 유용합니다.

NVM은 크로스 플랫폼인가요?

원래의 NVM(nvm-sh/nvm)은 주로 Unix 시스템(Linux, macOS)용으로 설계되었습니다. Windows의 경우, nvm-windows라는 별도의 구현이 있으며 유사하지만 동일하지 않은 기능을 제공합니다. 두 버전 간에는 명령어와 동작에 미묘한 차이가 있습니다.

어떤 버전의 NVM을 선택해야 하나요?

Windows를 사용하는 경우, nvm-windows를 선택해야 합니다
Linux나 macOS를 사용하는 경우, 원래의 nvm-sh/nvm을 선택해야 합니다
Windows에서 WSL(Windows Subsystem for Linux)을 사용하는 경우, WSL 환경에 원래의 nvm-sh/nvm을 설치해야 합니다

설치 문제

Windows에서 NVM 설치 후 "런타임 오류 R6034"

이 오류는 일반적으로 Visual C++ 런타임 충돌과 관련이 있습니다. 다음 해결책을 시도해 보세요:

nvm-windows 재설치
최신 버전의 Visual C++ Redistributable 패키지가 있는지 확인
관리자 권한으로 명령 프롬프트 실행 시도

국내 소스를 사용한 느리거나 실패하는 설치

중국 본토에 있는 경우, 미러 소스를 구성해야 할 수 있습니다:

Windows 버전

bash

nvm npm_mirror https://npmmirror.com/mirrors/npm/
nvm node_mirror https://npmmirror.com/mirrors/node/

nvm-windows 자주 묻는 질문 (FAQ) ​

일반적인 문제 ​

PowerShell에서 NVM 명령어가 인식되지 않음 ​

Node.js 설치 후 오류 ​

nvm use가 작동하지 않음 ​

NVM과 Node.js 직접 설치의 차이점은 무엇인가요? ​

NVM은 크로스 플랫폼인가요? ​

어떤 버전의 NVM을 선택해야 하나요? ​

설치 문제 ​

Windows에서 NVM 설치 후 "런타임 오류 R6034" ​

국내 소스를 사용한 느리거나 실패하는 설치 ​

Windows 버전 ​