Skip to content

Windows용 NVM 자주 묻는 질문

설치 문제

"nvm은 내부 또는 외부 명령, 실행할 수 있는 프로그램 또는 배치 파일이 아닙니다" 오류가 발생하는 이유는 무엇인가요?

이 오류는 Windows가 시스템 경로에서 nvm 명령을 찾을 수 없을 때 발생합니다. 해결하려면:

  1. 설치 후 컴퓨터를 재시작합니다
  2. 문제가 지속되면 NVM 설치 경로가 PATH 환경 변수에 있는지 확인합니다:
    • 제어판 > 시스템 > 고급 시스템 설정 > 환경 변수를 엽니다
    • 사용자 PATH 변수에 NVM 경로(예: C:\Users\<username>\AppData\Roaming\nvm)가 포함되어 있는지 확인합니다

NVM을 설치하기 전에 Node.js를 제거해야 하나요?

예, Windows용 NVM을 설치하기 전에 기존 Node.js 버전을 제거하는 것이 좋습니다. 이렇게 하면 전역 Node.js 설치와 NVM에서 관리하는 버전 간의 충돌을 방지할 수 있습니다.

Node.js 버전을 잃지 않고 NVM을 재설치하려면 어떻게 해야 하나요?

NVM을 재설치해야 하지만 Node.js 버전을 유지하고 싶다면:

  1. C:\Users\<username>\AppData\Roaming\nvm 디렉토리를 백업합니다
  2. NVM을 제거합니다
  3. 새 버전의 NVM을 설치합니다
  4. 백업에서 디렉토리 내용을 복원합니다

Node.js 문제

특정 Node.js 버전을 설치할 수 없는 이유는 무엇인가요?

특정 버전 설치에 문제가 있다면:

  1. 안정적인 인터넷 연결이 있는지 확인합니다
  2. 관리자로 명령 프롬프트를 실행합니다
  3. 일시적으로 바이러스 백신이나 방화벽을 비활성화합니다
  4. 대체 미러를 사용해 봅니다:
    bash
    nvm node_mirror https://npmmirror.com/mirrors/node/

프로젝트에 특정 Node.js 버전을 사용하려면 어떻게 해야 하나요?

프로젝트에 Node.js 버전을 지정하는 두 가지 방법이 있습니다:

  1. 프로젝트 루트에 버전 번호(예: 18.16.0)가 포함된 .nvmrc 파일을 만듭니다
  2. 프로젝트 작업 시 수동으로 원하는 버전으로 전환합니다:
    bash
    nvm use 18.16.0

전역 패키지 설치 시 권한 오류가 발생하는 이유는 무엇인가요?

npm 전역 패키지 설치 시 권한 오류가 발생하면:

  1. 관리자 권한으로 명령 프롬프트를 실행하고 있는지 확인합니다
  2. 올바른 Node.js 버전을 사용하고 있는지 확인합니다:
    bash
    nvm current

구성 문제

Node.js의 기본 버전을 어떻게 구성하나요?

새 터미널 창을 열 때마다 사용할 기본 버전을 구성하려면:

bash
nvm alias default 18.16.0

Node.js 다운로드 속도를 어떻게 높일 수 있나요?

다운로드가 느리다면 위치에 더 가까운 미러를 사용하도록 NVM을 구성할 수 있습니다:

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

더 많은 옵션은 미러 가이드를 참조하세요.

NVM 설정은 어디에 저장되나요?

Windows용 NVM 설정은 다음 위치에 저장됩니다:

  • NVM 구성: C:\Users\<username>\AppData\Roaming\nvm\settings.txt
  • 설치된 Node.js 버전: C:\Users\<username>\AppData\Roaming\nvm\<version>

Windows 특정 문제

NVM이 PowerShell에서 작동하나요?

예, Windows용 NVM은 명령 프롬프트(cmd)와 PowerShell 모두에서 작동합니다. 그러나 PowerShell에서 문제가 발생하면 스크립트 실행이 활성화되어 있는지 확인하세요:

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Visual Studio Code에서 NVM을 어떻게 사용하나요?

Visual Studio Code에서 NVM을 사용하려면:

  1. nvm alias default <version>으로 Node.js 기본 버전을 설정합니다
  2. VS Code를 재시작하여 Node.js 버전을 감지하게 합니다
  3. 또는 VS Code 설정에서 Node.js 버전의 전체 경로를 지정할 수 있습니다

WSL(Windows Subsystem for Linux)에서 NVM을 어떻게 사용하나요?

Windows용 NVM은 WSL에서 직접 작동하지 않습니다. WSL은 Linux 환경을 사용하기 때문입니다. WSL에서는 Linux 버전의 NVM(nvm-sh/nvm)을 설치해야 합니다. 지침은 nvm-sh 설치 가이드를 참조하세요.

고급 문제 해결

NVM 문제를 디버깅하려면 어떻게 해야 하나요?

NVM이 무엇을 하고 있는지에 대한 더 많은 정보를 얻으려면 로깅을 활성화할 수 있습니다:

  1. NVM 설치 디렉토리에서 settings.txt 파일을 생성하거나 편집합니다
  2. 다음 줄을 추가합니다: root: <NVM 설치 경로>
  3. 다음 줄을 추가합니다: log: <로그를 저장하고 싶은 경로>

버그를 어떻게 기여하거나 보고하나요?

버그를 발견하거나 프로젝트에 기여하고 싶다면:

  1. nvm-windows GitHub 저장소에 문제를 보고합니다
  2. 운영 체제, NVM 버전 및 문제를 재현하는 단계에 대한 세부 정보를 포함해야 합니다

일반적인 질문

Windows용 NVM과 nvm-sh의 차이점은 무엇인가요?

Windows용 NVM(nvm-windows)은 Windows용으로 특별히 재구현된 NVM이고, nvm-sh/nvm은 Unix/Linux 시스템용 원래 구현입니다. 비슷한 목적을 공유하지만 코드베이스가 다르고 명령어와 기능에 약간의 차이가 있습니다.

32비트 운영 체제에서 Windows용 NVM을 사용할 수 있나요?

예, Windows용 NVM은 32비트 및 64비트 Windows 운영 체제와 호환됩니다. nvm arch 명령을 사용하여 아키텍처 간에 전환할 수 있습니다.

NVM이 npm을 자동으로 설치하나요?

예, NVM을 사용하여 Node.js 버전을 설치하면 npm이 Node.js 패키지의 일부로 자동 설치됩니다.

VitePress로 제작됨