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-enabled | Corepack を有効化 | false |
--resolve-engines | package.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 --usefnm 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-missingfnm list
ローカルにインストールされた Node.js バージョンを一覧表示します。
bash
fnm list [OPTIONS]エイリアス: ls
例:
bash
fnm list出力例:
* v20.10.0 default
v18.19.0
v16.20.2fnm 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 --latestfnm uninstall
Node.js バージョンをアンインストールします。
bash
fnm uninstall [OPTIONS] [VERSION]エイリアス: uni
例:
bash
# 特定のバージョンをアンインストール
fnm uninstall 16.20.2
# エイリアス経由でアンインストール
fnm uninstall defaultWARNING
エイリアスが提供された場合、fnm はそのエイリアスが指す Node.js バージョンと、同じバージョンを指す他のエイリアスも削除します。
バージョン管理コマンド
fnm default
デフォルトの Node.js バージョンを設定または取得します。
bash
fnm default [VERSION]例:
bash
# デフォルトバージョンを設定
fnm default 20
# 現在のデフォルトバージョンを取得
fnm defaultfnm current
現在使用されている Node.js バージョンを表示します。
bash
fnm current例:
bash
fnm current
# 出力:v20.10.0fnm alias
バージョンのエイリアスを設定します。
bash
fnm alias <VERSION> <NAME>例:
bash
# エイリアスを設定
fnm alias 20 default
fnm alias 18 legacy
# エイリアスを使用
fnm use defaultfnm 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-cdfnm 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コマンドチートシート
| コマンド | エイリアス | 説明 |
|---|---|---|
install | i | Node.js バージョンをインストール |
use | - | Node.js バージョンを切り替え |
list | ls | インストール済みバージョンを一覧表示 |
list-remote | ls-remote | リモートバージョンを一覧表示 |
uninstall | uni | Node.js バージョンをアンインストール |
default | - | デフォルトバージョンを設定/取得 |
current | - | 現在のバージョンを表示 |
alias | - | バージョンエイリアスを設定 |
unalias | - | エイリアスを削除 |
env | - | 環境設定を出力 |
completions | - | 補完スクリプトを出力 |
exec | - | 指定バージョンでコマンドを実行 |
関連リンク
- Node.js をインストール - 詳細なインストールガイド
- バージョン管理 - バージョン管理のベストプラクティス
- install コマンド - install コマンドの詳細解説