macOS 에서 fnm 설치

fnm 은 macOS 에서 여러 설치 방법을 제공합니다. 이 가이드는 가장 적합한 방법을 선택하는 데 도움을 드립니다.

설치 방법

Homebrew 사용 (권장)

Homebrew 는 macOS 에서 가장 인기 있는 패키지 관리자입니다:

# fnm 설치
brew install fnm

curl 스크립트 사용

패키지 관리자 없이 직접 설치:

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

MacPorts 사용

MacPorts 를 사용하는 경우:

port install fnm

수동 다운로드

1. fnm Releases 페이지 방문
2. fnm-macos.zip (Intel) 또는 fnm-macos-arm64.zip (Apple Silicon) 다운로드
3. 압축 해제 후 PATH 디렉토리로 이동:

# Apple Silicon (M1/M2/M3)
unzip fnm-macos-arm64.zip
sudo mv fnm /usr/local/bin

# Intel Mac
unzip fnm-macos.zip
sudo mv fnm /usr/local/bin

Shell 구성

macOS 는 기본적으로 Zsh 를 사용하지만 Bash 와 Fish 도 지원합니다.

Zsh (기본값)

~/.zshrc 편집:

# 구성 파일 열기
nano ~/.zshrc

# 다음 내용 추가
eval "$(fnm env --use-on-cd)"

구성 다시 로드:

source ~/.zshrc

Bash

~/.bashrc 또는 ~/.bash_profile 편집:

# 구성 파일 열기
nano ~/.bash_profile

# 다음 내용 추가
eval "$(fnm env --use-on-cd)"

구성 다시 로드:

source ~/.bash_profile

Fish

~/.config/fish/config.fish 편집:

# 구성 파일 열기
nano ~/.config/fish/config.fish

# 다음 내용 추가
fnm env --use-on-c | source

구성 다시 로드:

source ~/.config/fish/config.fish

Shell 완성

Zsh 완성

# 완성 스크립트 추가
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# fpath 에 완성 디렉토리가 포함되는지 확인
# ~/.zshrc 에 추가
fpath=(~/.zsh/completion $fpath)

# 완성 활성화
autoload -U compinit && compinit

또는 oh-my-zsh 사용:

# 완성 디렉토리 생성
mkdir -p ~/.oh-my-zsh/completions

# 완성 스크립트 생성
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Bash 완성

# 완성 스크립트 추가
fnm completions --shell bash >> ~/.bashrc

# 다시 로드
source ~/.bashrc

Fish 완성

# 완성 스크립트 생성
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# 다시 로드
source ~/.config/fish/config.fish

중국에서 미러 사용

중국 본토에서는 미러를 구성하여 다운로드 속도를 높이는 것이 권장됩니다:

# Shell 구성 파일에 추가
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# 또는 eval 에서 지정
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Apple Silicon (M1/M2/M3) 참고 사항

fnm 은 Apple Silicon 을 완전히 지원합니다:

• 시스템 아키텍처 자동 감지
• 네이티브 ARM64 버전의 Node.js 설치
• x64 에뮬레이션 지원 (Rosetta 2 를 통해)

x64 버전 설치

x64 버전의 Node.js 가 필요한 경우:

# x64 아키텍처 Node.js 설치
fnm install 20 --arch=x64

설치 확인

# fnm 버전 확인
fnm --version

# Node.js 설치
fnm install --lts

# Node.js 확인
node --version
npm --version

일반적인 문제

Command Not Found

설치 후 fnm 명령어를 찾을 수 없는 경우:

# fnm 경로 확인
which fnm

# curl 로 설치한 경우 PATH 에 포함되는지 확인
echo $PATH

# PATH 에 수동으로 추가
export PATH="$HOME/.fnm:$PATH"

권한 문제

권한 문제가 발생하는 경우:

# 디렉토리에 올바른 권한이 있는지 확인
chmod +x ~/.fnm/fnm

Homebrew 설치가 작동하지 않음

# 다시 링크
brew unlink fnm && brew link fnm

# 설치 확인
brew list fnm

다음 단계

설치 후 다음을 수행할 수 있습니다:

• Node.js 설치 - fnm 을 사용하여 Node.js 설치
• 명령어 참조 - 사용 가능한 모든 명령어 알아보기
• 버전 관리 - 버전 관리 알아보기

관련 링크

• fnm 설치 - 일반 설치 가이드
• Windows 설치 - Windows 설치 가이드
• Linux 설치 - Linux 설치 가이드