Question 1

zsh에서 nvm.sh를 소싱할 때 발생하는 nvm 오류 "cdhist: error: unrecognized arguments: -q"를 해결하는 방법

Accepted Answer

이 문제는 `cdhist`의 사용자 정의 `cd` 셸 함수가 zsh의 내장 `cd`를 가리기 때문에 발생합니다. nvm은 zsh에서 `cd -q`를 실행하지만, `cdhist`는 `-q` 플래그를 지원하지 않아 `NVM_DIR`이 `/`가 됩니다.

사용자 정의 `cd` 함수를 우회하고 셸 내장 명령을 직접 호출하는 `nvm_cd` 수정 사항이 포함된 릴리스로 nvm을 업그레이드하세요.

즉시 적용 가능한 패치: `~/.nvm/nvm.sh`를 열고 `nvm_cd()`를 찾아 다음과 같이 변경하세요:

```sh
nvm_cd() {
  if nvm_is_zsh; then
    builtin cd "$@"
  else
    command cd "$@"
  fi
}
```

그런 다음 다시 로드하세요:

```sh
source ~/.nvm/nvm.sh
```

현재 셸에만 적용되는 임시 해결 방법:

```sh
unset -f cd
source ~/.nvm/nvm.sh
```

이렇게 하면 셸이 재시작될 때까지 `cdhist`의 `cd` 함수가 비활성화됩니다.

Question 2

nvm 설치 스크립트가 ~/.bashrc의 마지막 줄에 bash_completion을 추가하는 문제를 어떻게 해결하나요?

Accepted Answer

이 문제는 `~/.bashrc`의 끝에 줄바꿈 문자가 없고 이미 `nvm.sh`와 일치하는 줄이 포함되어 있을 때 nvm v0.40.8의 설치 프로그램에서 발생하며, 완성(completion) 줄이 새 줄을 시작하지 않고 추가됩니다. 이를 해결하려면 `~/.bashrc`를 열고 nvm 완성 스니펫을 별도의 줄로 옮기세요:

```bash
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
```

설치 프로그램을 다시 실행하기 전에 파일이 줄바꿈으로 끝나는지 확인하세요:

```bash
[ -n "$(tail -c1 ~/.bashrc)" ] && printf '
' >> ~/.bashrc
```

그런 다음 최신 nvm 설치 프로그램을 다시 실행하세요. 최신 버전에는 줄바꿈으로 끝나지 않는 프로필에 내용을 추가하기 전에 줄바꿈을 먼저 작성하는 수정 사항이 포함되어 있습니다.

Question 3

별도의 Node.js 설치가 존재하지 않을 때 macOS에서 nvm의 "not compatible with the npm config prefix option" 오류를 어떻게 해결하나요?

Accepted Answer

이 문제는 macOS가 실제 폴더와 대소문자가 다른 홈 디렉터리 경로를 보고할 때 발생할 수 있으며, 흔히 Time Machine 복원이나 계정 마이그레이션 이후에 나타납니다. 예를 들어 `$HOME`은 `/Users/mitch`인데 실제 폴더는 `/Users/Mitch`인 경우입니다. 다음 명령어로 경로를 비교하세요:

```sh
echo "$HOME"
whoami
ls -ld /Users/*
```

대소문자가 다르면 홈 디렉터리 경로를 수정하세요:

1. Mac을 백업하고 해당 계정에서 로그아웃하세요.
2. **시스템 환경설정 → 사용자 및 그룹**으로 이동하세요.
3. 해당 사용자를 우클릭하고 **고급 옵션**을 선택하세요.
4. **홈 디렉터리**를 실제 대소문자가 반영된 경로(예: `/Users/Mitch`)로 설정하세요.
5. 저장한 후 Mac을 재시동하고 터미널을 다시 여세요.
6. nvm이 설치된 버전에 대해 여전히 prefix를 보고하는 경우 다음을 실행하세요:

```sh
nvm use --delete-prefix v14.5.0
```

`v14.5.0`을 nvm으로 설치한 Node 버전으로 바꾸세요. nvm을 업데이트하면 이 경우에 대한 개선된 경고가 표시될 수도 있습니다. 이 감지 문제는 nvm PR #2263에서 해결되었습니다.

Question 4

nvm이 zsh 시작을 느리게 하는 이유는 무엇이며, 지연 시간을 어떻게 줄일 수 있나요?

Accepted Answer

이 지연은 주로 `nvm.sh`가 소싱될 때 nvm이 자동으로 `nvm use default`를 실행하기 때문에 발생합니다. `--no-use` 옵션을 사용해 nvm을 소싱하여 해당 버전 선택을 지연시키세요.

`~/.zshrc`에서 다음을:

```sh
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
```

다음으로 교체하세요:

```sh
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" --no-use
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
```

셸을 재시작하세요:

```sh
exec zsh
```

해당 이슈의 벤치마크에서 일반 로딩은 약 303 ms가 걸렸고, `--no-use`는 셸 시작 시간을 약 75 ms로 줄였습니다. nvm 소싱 자체는 대략 44 ms가 소요되었고, 나머지 시간은 자동 기본 버전 선택에 사용되었습니다.

`--no-use`를 사용하는 경우 Node가 필요할 때 다음을 실행하세요:

```sh
nvm use default
```

또는 `nvm`, `node`, `npm`, `npx`가 처음 호출될 때만 nvm을 지연 로드(lazy-load)하세요:

```sh
export NVM_DIR="$HOME/.nvm"

_lazy_load_nvm() {
  unset -f nvm node npm npx
  [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
  [ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
}

nvm() { _lazy_load_nvm; nvm "$@"; }
node() { _lazy_load_nvm; node "$@"; }
npm() { _lazy_load_nvm; npm "$@"; }
npx() { _lazy_load_nvm; npx "$@"; }
```

다음 명령으로 시작 시간을 측정하세요:

```sh
hyperfine --warmup 3 'zsh -i -c exit'
```

Question 5

Windows 호스트에 Node.js/npm이 설치되어 있을 때 WSL에서 nvm 설치가 실패하는 이유는 무엇인가요?

Accepted Answer

**원인:** nvm의 설치 스크립트가 `nvm_check_global_modules`를 통해 `npm`을 호출합니다. WSL에서는 기본적으로 Windows 경로가 `$PATH`에 추가되므로, `npm`이 `/mnt/c/Program Files/nodejs/npm`으로 해석될 수 있습니다. 이는 Windows Node.js 설치에 함께 포함된 셸 스크립트로, Windows `node.exe`를 실행합니다. 이로 인해 설치가 깨집니다.

**해결 방법 1 — Windows PATH가 WSL로 유출되지 않도록 차단 (권장):**
1. WSL 내에서 `/etc/wsl.conf`를 생성하거나 편집합니다:
   ```ini
   [interop]
   appendWindowsPath = false
   ```
2. Windows의 PowerShell에서 `wsl --shutdown`을 실행한 다음 WSL 터미널을 다시 엽니다.
3. nvm 설치 스크립트를 다시 실행합니다.

**해결 방법 2 — 설치할 때만 Windows 경로를 일시적으로 제거:**
```sh
PATH=$(echo "$PATH" | tr ':' '
' | grep -v '^/mnt/c' | paste -sd: -)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
```

`which npm`으로 확인하세요. `/mnt/c/...`를 가리키지 않아야 합니다. nvm 자체에서의 수정(Windows `node.exe`가 `npm` 옆에 있는 경우 npm 검사를 건너뛰는 방식)이 제안되었으므로, 릴리스된 후 nvm을 업그레이드해도 문제가 해결될 수 있습니다.

nvm

개요

README 미리보기

FAQ (5)

同类型项目

hermes-agent

firecrawl

go

markitdown