Skip to content

fnm use 명령어 가이드

fnm use 명령어는 현재 사용 중인 Node.js 버전을 전환하는 데 사용됩니다.

명령어 구문

bash
fnm use [OPTIONS] [VERSION]

매개변수

VERSION

전환할 Node.js 버전을 지정합니다:

bash
# 주요 버전으로 전환
fnm use 20

# 특정 버전으로 전환
fnm use 20.10.0

# 별칭 사용
fnm use default

# 버전 지정 안 함, 버전 파일에서 읽기
fnm use

옵션

--install-if-missing

버전이 설치되지 않은 경우 자동으로 설치합니다:

bash
fnm use 18 --install-if-missing

--silent-if-unchanged

버전이 변경되지 않은 경우 메시지를 출력하지 않습니다:

bash
fnm use 20 --silent-if-unchanged

--node-dist-mirror

--install-if-missing 과 함께 사용하여 다운로드 미러를 지정합니다:

bash
fnm use 18 --install-if-missing --node-dist-mirror=https://npmmirror.com/mirrors/node

--fnm-dir

fnm 설치 디렉토리를 지정합니다:

bash
fnm use 20 --fnm-dir=/custom/path

--log-level

로그 레벨을 설정합니다:

bash
fnm use 20 --log-level=quiet

사용 예제

기본 전환

bash
# Node.js 20 으로 전환
fnm use 20

# Node.js 18.17.0 으로 전환
fnm use 18.17.0

자동 설치 및 전환

bash
# 버전이 설치되지 않은 경우 자동으로 설치
fnm use 16 --install-if-missing

별칭을 사용하여 전환

bash
# 미리 설정된 별칭 사용
fnm use default
fnm use legacy

무음 모드

bash
# 스크립트에서 불필요한 출력 방지를 위해 사용
fnm use 20 --silent-if-unchanged

버전 선택 우선순위

버전을 지정하지 않으면 fnm 은 다음 순서로 검색합니다:

  1. .node-version 파일
  2. .nvmrc 파일
  3. package.json engines.node
  4. 기본 버전

default 명령어와의 차이점

  • fnm use - 현재 Shell 세션의 버전을 전환합니다
  • fnm default - 전역 기본 버전을 설정합니다
bash
# 기본 버전 설정 (새 터미널에 영향)
fnm default 20

# 임시로 버전 전환 (현재 터미널만)
fnm use 18

일반적인 문제

버전이 설치되지 않음

bash
# 오류 메시지
error: Can't find version 18.0.0

# 해결책: 자동 설치
fnm use 18 --install-if-missing

전환 후 node 버전이 변경되지 않음

Shell 구성이 올바른지 확인합니다:

bash
# node 경로 확인
which node

# fnm 디렉토리를 가리켜야 함
# ~/.fnm/node-versions/.../bin/node

버전 파일이 작동하지 않음

bash
# --use-on-cd 가 활성화되었는지 확인
eval "$(fnm env --use-on-cd)"

# 버전 파일이 존재하는지 확인
cat .node-version

관련 링크