Skip to content

macOS に fnm をインストール

fnm は macOS で複数のインストール方法があります。このガイドでは、最も適した方法を選択するのに役立ちます。

インストール方法

Homebrew を使用(推奨)

Homebrew は macOS で最も人気のあるパッケージマネージャーです:

bash
# fnm をインストール
brew install fnm

curl スクリプトを使用

パッケージマネージャー不要、直接インストール:

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

MacPorts を使用

MacPorts を使用している場合:

bash
port install fnm

手動ダウンロード

  1. fnm リリースページ にアクセス
  2. fnm-macos.zip(Intel)または fnm-macos-arm64.zip(Apple Silicon)をダウンロード
  3. 解凍して PATH ディレクトリに移動:
bash
# 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 を編集:

bash
# 設定ファイルを開く
nano ~/.zshrc

# 以下の内容を追加
eval "$(fnm env --use-on-cd)"

設定をリロード:

bash
source ~/.zshrc

Bash

~/.bashrc または ~/.bash_profile を編集:

bash
# 設定ファイルを開く
nano ~/.bash_profile

# 以下の内容を追加
eval "$(fnm env --use-on-cd)"

設定をリロード:

bash
source ~/.bash_profile

Fish

~/.config/fish/config.fish を編集:

fish
# 設定ファイルを開く
nano ~/.config/fish/config.fish

# 以下の内容を追加
fnm env --use-on-c | source

設定をリロード:

fish
source ~/.config/fish/config.fish

Shell 補完

Zsh 補完

bash
# 補完スクリプトを追加
fnm completions --shell zsh > ~/.zsh/completion/_fnm

# fpath に補完ディレクトリが含まれていることを確認
# ~/.zshrc に追加
fpath=(~/.zsh/completion $fpath)

# 補完を有効化
autoload -U compinit && compinit

または oh-my-zsh を使用:

bash
# 補完ディレクトリを作成
mkdir -p ~/.oh-my-zsh/completions

# 補完スクリプトを生成
fnm completions --shell zsh > ~/.oh-my-zsh/completions/_fnm

Bash 補完

bash
# 補完スクリプトを追加
fnm completions --shell bash >> ~/.bashrc

# リロード
source ~/.bashrc

Fish 補完

bash
# 補完スクリプトを生成
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# リロード
source ~/.config/fish/config.fish

中国のミラーを使用

中国本土では、ダウンロードを高速化するためにミラーの設定を推奨:

bash
# 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 バージョンをインストール

Node.js の x64 バージョンが必要な場合:

bash
# x64 アーキテクチャの Node.js をインストール
fnm install 20 --arch=x64

インストールの確認

bash
# fnm バージョンを確認
fnm --version

# Node.js をインストール
fnm install --lts

# Node.js を確認
node --version
npm --version

よくある問題

コマンドが見つからない

インストール後に fnm コマンドが見つからない場合:

bash
# fnm パスを確認
which fnm

# curl でインストールした場合、PATH が含まれていることを確認
echo $PATH

# 手動で PATH に追加
export PATH="$HOME/.fnm:$PATH"

権限の問題

権限問題が発生した場合:

bash
# ディレクトリに正しい権限があることを確認
chmod +x ~/.fnm/fnm

Homebrew インストールが機能しない

bash
# 再リンク
brew unlink fnm && brew link fnm

# インストールを確認
brew list fnm

次のステップ

インストール後、以下を実行できます:

関連リンク