Skip to content

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-enabledCorepack を有効化false
--resolve-enginespackage.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

コマンドチートシート

コマンドエイリアス説明
installiNode.js バージョンをインストール
use-Node.js バージョンを切り替え
listlsインストール済みバージョンを一覧表示
list-remotels-remoteリモートバージョンを一覧表示
uninstalluniNode.js バージョンをアンインストール
default-デフォルトバージョンを設定/取得
current-現在のバージョンを表示
alias-バージョンエイリアスを設定
unalias-エイリアスを削除
env-環境設定を出力
completions-補完スクリプトを出力
exec-指定バージョンでコマンドを実行

関連リンク