fnm 명령어 참조

fnm 은 Node.js 버전을 관리하기 위한 간결하고 강력한 명령줄 도구 세트를 제공합니다.

명령어 개요

fnm [OPTIONS] <COMMAND>

전역 옵션

옵션	설명	기본값
`--node-dist-mirror <URL>`	Node.js 다운로드 미러	`https://nodejs.org/dist`
`--fnm-dir <DIR>`	fnm 설치 디렉토리	`~/.fnm`
`--log-level <LEVEL>`	로그 레벨	`info`
`--arch <ARCH>`	아키텍처 재정의	시스템 아키텍처
`--version-file-strategy <STRATEGY>`	버전 파일 구문 분석 전략	`local`
`--corepack-enabled`	Corepack 활성화	`false`
`--resolve-engines`	package.json 의 engines.node 해결	`true`

핵심 명령어

fnm install

새 Node.js 버전을 설치합니다.

bash

fnm install [OPTIONS] [VERSION]

매개변수:

VERSION - 버전 번호, 부분 semver 또는 LTS 버전 이름 (예: lts/iron)

옵션:

--lts - 최신 LTS 버전 설치
--latest - 최신 버전 설치
--use - 설치 후 즉시 버전 사용
--progress <auto|never|always> - 다운로드 진행률 표시줄 표시

예제:

bash

# fnm 버전
fnm --version


# 최신 LTS 버전 설치
fnm install --lts

# 최신 버전 설치
fnm install --latest

# 특정 버전 설치
fnm install 20
fnm install 18.17.0

# 특정 LTS 버전 설치
fnm install lts/iron

# 설치 후 즉시 사용
fnm install 20 --use

fnm use

Node.js 버전을 전환합니다.

bash

fnm use [OPTIONS] [VERSION]

옵션:

--install-if-missing - 버전이 설치되지 않은 경우 자동으로 설치
--silent-if-unchanged - 버전이 변경되지 않은 경우 메시지 출력 안 함

예제:

bash

# 특정 버전 사용
fnm use 20

# 설치된 최신 버전 사용
fnm use

# 설치되지 않은 경우 자동 설치
fnm use 18 --install-if-missing

fnm list

로컬에 설치된 Node.js 버전을 나열합니다.

bash

fnm list [OPTIONS]

별칭: ls

예제:

bash

fnm list

출력 예제:

* v20.10.0 default
  v18.19.0
  v16.20.2

fnm list-remote

사용 가능한 모든 원격 Node.js 버전을 나열합니다.

bash

fnm list-remote [OPTIONS]

별칭: ls-remote

옵션:

--filter <FILTER> - 버전 번호 또는 semver 범위로 필터링
--lts [<NAME>] - LTS 버전만 표시
--latest - 최신 버전만 표시
--sort <asc|desc> - 정렬 순서

예제:

bash

# 모든 버전 나열
fnm list-remote

# LTS 버전만 나열
fnm list-remote --lts

# 특정 LTS 버전 나열
fnm list-remote --lts=iron

# 버전 필터링
fnm list-remote --filter=18

# 최신 버전만 표시
fnm list-remote --latest

fnm uninstall

Node.js 버전을 제거합니다.

bash

fnm uninstall [OPTIONS] [VERSION]

별칭: uni

예제:

bash

# 특정 버전 제거
fnm uninstall 16.20.2

# 별칭을 통해 제거
fnm uninstall default

WARNING

별칭을 제공하면 fnm 은 해당 별칭이 가리키는 Node.js 버전과 동일한 버전을 가리키는 다른 별칭도 삭제합니다.

버전 관리 명령어

fnm default

기본 Node.js 버전을 설정하거나 가져옵니다.

bash

fnm default [VERSION]

예제:

bash

# 기본 버전 설정
fnm default 20

# 현재 기본 버전 가져오기
fnm default

fnm current

현재 사용 중인 Node.js 버전을 표시합니다.

bash

fnm current

예제:

bash

fnm current
# 출력: v20.10.0

fnm alias

버전의 별칭을 설정합니다.

bash

fnm alias <VERSION> <NAME>

예제:

bash

# 별칭 설정
fnm alias 20 default
fnm alias 18 legacy

# 별칭 사용
fnm use default

fnm unalias

별칭을 삭제합니다.

bash

fnm unalias <NAME>

예제:

bash

fnm unalias legacy

환경 구성 명령어

fnm env

Shell 환경 변수 구성을 출력합니다.

bash

fnm env [OPTIONS]

옵션:

--shell <bash|zsh|fish|powershell> - Shell 유형 지정
--json - JSON 형식으로 출력
--use-on-cd - 자동 버전 전환 스크립트 출력

예제:

bash

# 현재 Shell 구성 출력
fnm env

# Bash 구성 출력
fnm env --shell bash

# JSON 형식 출력
fnm env --json

# 자동 버전 전환 활성화
fnm env --use-on-cd

fnm completions

Shell 완성 스크립트를 출력합니다.

bash

fnm completions [OPTIONS]

옵션:

--shell <bash|zsh|fish|powershell> - Shell 유형 지정

예제:

bash

# Bash
fnm completions --shell bash >> ~/.bashrc

# Zsh
fnm completions --shell zsh >> ~/.zshrc

# Fish
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# PowerShell
fnm completions --shell powershell >> $PROFILE

고급 명령어

fnm exec

지정된 Node.js 버전 환경에서 명령어를 실행합니다.

bash

fnm exec [OPTIONS] -- <COMMAND>

옵션:

--using <VERSION> - 사용할 버전 지정

예제:

bash

# Node.js 18 을 사용하여 명령어 실행
fnm exec --using=18 -- node --version

# 특정 버전을 사용하여 스크립트 실행
fnm exec --using=20 -- npm run build

명령어 치트 시트

명령어	별칭	설명
`install`	`i`	Node.js 버전 설치
`use`	-	Node.js 버전 전환
`list`	`ls`	설치된 버전 나열
`list-remote`	`ls-remote`	원격 버전 나열
`uninstall`	`uni`	Node.js 버전 제거
`default`	-	기본 버전 설정/가져오기
`current`	-	현재 버전 표시
`alias`	-	버전 별칭 설정
`unalias`	-	별칭 삭제
`env`	-	환경 구성 출력
`completions`	-	완성 스크립트 출력
`exec`	-	지정된 버전에서 명령어 실행

fnm 명령어 참조 ​

명령어 개요 ​

전역 옵션 ​

핵심 명령어 ​

fnm install ​

fnm use ​

fnm list ​

fnm list-remote ​

fnm uninstall ​

버전 관리 명령어 ​

fnm default ​

fnm current ​

fnm alias ​

fnm unalias ​

환경 구성 명령어 ​

fnm env ​

fnm completions ​

고급 명령어 ​

fnm exec ​

명령어 치트 시트 ​

관련 링크 ​

fnm 명령어 참조

명령어 개요

전역 옵션

핵심 명령어

fnm install

fnm use

fnm list

fnm list-remote

fnm uninstall

버전 관리 명령어

fnm default

fnm current

fnm alias

fnm unalias

환경 구성 명령어

fnm env

fnm completions

고급 명령어

fnm exec

명령어 치트 시트

관련 링크