[DevTools] nvm보다 40배 빠른 노드 버전 관리 도구 — fnm

Node 버전 관리 도구로 줄곧 nvm을 사용하다가 Rust로 작성된 fnm이 nvm에 비해 40배 이상 빠르다는 글을 보고 바꿔야겠다고 마음먹었다. volta, fnm 둘 중 고민하다가 결국 fnm을 선택했다. nvm 인터페이스와 거의 동일하고 .nvmrc 파일을 지원하는 점이 마음에 들었다.

 

nvm은 bash 스크립트로 작성됐기 때문에 기본적으로 Unix 계열에서만 작동하는 반면, fnm은 Windows도 지원하는 장점이 있다. fnm으로 바꾸고 나서부터 터미널 로드 속도가 훨씬 빨라진 게 체감된다. 참고로 fnm은 Fast Node Manager의 약자다.

 

 

설치 방법

---

❶ nvm 관련 파일 삭제 : rm -rf ~/.nvm

❷ ~/.bashrc, ~/.bash_profile, ~/.zshrc, ~/.profile 등 프로파일에 있는 nvm 관련 내용 삭제

❸ 쉘 재시작 : source ~/.zshrc

 

패키지 설치

방법 1 - Homebrew로 설치

brew install fnm

 

방법 2 - 스크립트로 설치

curl -fsSL https://fnm.vercel.app/install | bash

 

구성 설정

fnm에서 기본적으로 비활성화된 기능은 fnm env 뒤에 기능 플래그를 추가해서 활성화할 수 있다. 전체 플래그 목록은 fnm 공식 문서에서 찾을 수 있다. 아래 코드를 ~/.zshrc 파일에 추가한다.

eval "$(fnm env --use-on-cd --version-file-strategy=recursive)"

 

아래 두 플래그 모두 공식 문서에서 권장하는 기능으로 활성화해 두고 사용하는 걸 추천한다.

• --use-on-cd : 폴더 이동시 .node-version 또는 .nvmrc 파일에 명시한 노드 버전으로 자동 전환
• --version-file-strategy=recursive : 상위 디렉토리의 .node-version 파일도 고려
  fnm use 명령어 뒤에 버전명을 적지 않은 경우, 현재 폴더에서 .node-version 파일을 찾고, 없다면 상위 폴더를 재귀적으로 탐색해서 버전 정보를 가져온다.

 

자동 완성 설정

Oh My Zsh 사용자는 ~/.zshrc 파일 plugins 배열에 fnm을 추가하면 명령어 자동 완성을 사용할 수 있다.

plugins=(... fnm)

 

Oh My Zsh를 사용하지 않는다면 아래 코드를 ~/.zshrc 파일에 추가해서 설정할 수 있다. (#171 Issue 참고)

# Homebrew의 zsh 자동 완성 기능 경로를 fpath에 추가
fpath+="/opt/homebrew/share/zsh/site-functions"

# compinit 함수 미리 로드
autoload -Uz compinit

# zsh 자동 완성 기능 초기화
compinit

 

 

노드 버전 자동 전환

---

설치를 완료하고 .node-version 혹은 .nvmrc 파일에 노드 버전을 명시해 두면 해당 폴더에 접근할 때마다 노드 버전이 자동으로 전환된다. 해당 노드 버전이 설치되어 있지 않다면 설치 여부를 묻는 프롬프트가 표시된다.

# .node-version 파일 예시
20.14.0

 

echo 명령어를 활용하면 .node-version 파일을 더 편하게 생성할 수 있다.

# echo 출력 결과를 .node-version 파일에 덮어쓰기
echo '20.14.0' > .node-version

 

 

주요 명령어

---

설치한 노드는 ~/.local/share/fnm/node-versions/v<version> 경로에서 찾을 수 있다.

# 지정한 노드 버전 설치
fnm install <version>

# LTS 버전 노드 설치
fnm install --lts

# 지정한 노드 버전 삭제
fnm uninstall <version>

# 로컬에 설치한 모든 노드 버전 출력
fnm list
fnm ls

# 모든 원격 노드 버전 출력
fnm list-remote
fnm ls-remote

# 지정한 노드 버전 사용
fnm use <version>

# 기본으로 설정한 노드 버전 사용
fnm use default

# 시스템에 설치된 노드 버전 사용
fnm use system

# 현재 사용 중인 노드 버전 출력
fnm current

# 기본 노드 버전 설정
fnm default <version>

# 노드 버전 별칭 설정
fnm alias <version> <name>

# 노드 버전 별칭 제거
fnm unalias <name>

 

 

글로벌 패키지 재설치

---

nvm은 --reinstall-packages-from=<old-version> 옵션을 통해 기존 노드 버전에 설치된 글로벌 NPM 패키지들을, 새로 설치할 노드 버전에 재설치할 수 있다. 아쉽게도 fnm은 이러한 옵션을 제공하지 않는다. GPT 도움을 받아 글로벌 패키지를 마이그레이션 하는 간단한 스크립트를 만들어봤다(아래 Gist 링크 참고).

 

Update to Node.js LTS and Migrate Global NPM Packages

 

스크립트를 실행하면 현재 노드 버전에 설치된 글로벌 NPM 패키지들을 새로 설치할 노드 버전에 재설치한다. -v 플래그로 설치할 노드 버전을 직접 지정할 수 있고, 생략하면 LTS 버전으로 설치한다.

 

# 스크립트 실행 명령어
curl -fsSL https://gist.githubusercontent.com/romantech/83ac87cea4e9a6d7a0985f610df329e5/raw/decd27fb4fb3c0aa6563a74e000dc00974f6f1e9/update-node-lts.sh | bash -s -- -v lts

 

스크립트 실행 화면

 

---

글 수정사항은 노션 페이지에 가장 빠르게 반영됩니다. 링크를 참고해 주세요