Skip to content

fnm で Node.js をインストール

fnm は Node.js バージョンのインストールと管理をシンプルかつ高速にします。このガイドでは、fnm を使用して Node.js をインストールする方法を詳しく説明します。

クイックスタート

最新の LTS バージョンをインストール

bash
fnm install --lts

最新バージョンをインストール

bash
fnm install --latest

特定のバージョンをインストール

bash
fnm install 20
fnm install 18.17.0

インストール方法の詳細

LTS バージョンをインストール

Node.js LTS(Long Term Support)バージョンは本番環境に推奨されます:

bash
# 最新の LTS バージョンをインストール
fnm install --lts

# 特定の LTS バージョンをインストール
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium  # Node.js 16.x

LTS バージョンコード名:

コード名バージョンステータス
Iron20.xアクティブ LTS
Hydrogen18.xメンテナンス
Gallium16.xライフサイクル終了

特定のバージョンをインストール

bash
# メジャーバージョンをインストール(最新のマイナーバージョンが自動的に選択されます)
fnm install 20

# 特定のバージョンをインストール
fnm install 20.10.0

# 古いバージョンをインストール
fnm install 14.21.3

バージョンファイルを使用してインストール

プロジェクトディレクトリに .node-version または .nvmrc ファイルを作成:

bash
# .node-version ファイルを作成
echo "20" > .node-version

# fnm が自動的に読み取ってインストール
fnm install

インストール後の使用

インストール済みバージョンに切り替え

bash
# 特定のバージョンを使用
fnm use 20

# バージョンがインストールされていない場合、自動インストールして使用
fnm use 18 --install-if-missing

デフォルトバージョンを設定

bash
# デフォルトバージョンを設定
fnm default 20

# 現在のデフォルトバージョンを表示
fnm default

インストール直後に使用

bash
# インストールしてすぐにバージョンを切り替え
fnm install 20 --use

利用可能なバージョンを表示

リモートバージョンを表示

bash
# 利用可能なすべてのバージョンを一覧表示
fnm list-remote

# LTS バージョンのみを一覧表示
fnm list-remote --lts

# 特定のバージョンでフィルタ
fnm list-remote --filter=18

# 最新バージョンを表示
fnm list-remote --latest

ローカルにインストールされたバージョンを表示

bash
fnm list

出力例:

* v20.10.0 default
  v18.19.0
  v16.20.2

ミラーを使用して高速ダウンロード

中国本土では、ミラーを使用してダウンロードを高速化できます:

bash
# ミラー環境変数を設定
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# またはインストール時に指定
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

一般的なミラー:

ミラーソースURL
npmmirrorhttps://npmmirror.com/mirrors/node
清華大学https://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Corepack サポート

fnm は Corepack をサポートし、Yarn と pnpm を自動有効化できます:

bash
# インストール時に Corepack を有効化
fnm install 20 --corepack-enabled

# または環境変数を設定
export FNM_COREPACK_ENABLED=true
fnm install 20

バージョン管理のベストプラクティス

プロジェクトレベルのバージョン管理

プロジェクトルートに .node-version ファイルを作成:

bash
# メジャーバージョンを指定
echo "20" > .node-version

# または正確なバージョンを指定
echo "20.10.0" > .node-version

--use-on-cd オプションと組み合わせて、ディレクトリに入ると自動的にバージョンを切り替え:

bash
# Shell 設定に追加
eval "$(fnm env --use-on-cd)"

マルチバージョン開発

bash
# 複数のバージョンをインストール
fnm install 20
fnm install 18
fnm install 16

# 異なるプロジェクト間で切り替え
cd project-a && fnm use 20
cd project-b && fnm use 18

エイリアスを使用

bash
# エイリアスを設定
fnm alias 20 default
fnm alias 18 legacy

# エイリアスを使用して切り替え
fnm use default
fnm use legacy

よくある問題

インストールに失敗

インストールに失敗した場合は、以下を確認してください:

  1. ネットワーク接続が正常か
  2. ミラーの設定が必要か
  3. 十分なディスク容量があるか
bash
# ミラーを使用して再試行
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

バージョン切り替えが機能しない

Shell が正しく設定されていることを確認:

bash
# 現在のバージョンを確認
fnm current

# node パスを確認
which node

古いバージョンをクリーンアップ

bash
# インストール済みバージョンを表示
fnm list

# 不要なバージョンをアンインストール
fnm uninstall 16.20.2

関連リンク