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.jsonengines.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

関連リンク