Back

Linux で NVM を使用して Node.js バージョンを切り替える方法(ステップバイステップガイド)

Linux で NVM を使用して Node.js バージョンを切り替える方法(ステップバイステップガイド)

複数の Node.js バージョンを管理することは、特に異なる Node.js 設定を必要とする複数のプロジェクトに取り組んでいる場合、煩雑になることがあります。Node Version Manager (NVM) を使用すると、Linux で Node.js バージョンを簡単かつクリーンに切り替えることができます。このガイドでは、NVM のインストール方法、Node バージョンの切り替え方法、デフォルト設定の方法、および一般的な問題の迅速な解決方法について詳しく説明します。

重要ポイント

  • NVM は競合なしに複数の Node.js バージョンを管理するのに役立ちます。
  • 権限の問題を避けるため、NVM と Node.js コマンドは常に sudo なしで実行してください。

ステップ 1: Linux に NVM をインストールする

ターミナルで次のコマンドを実行します:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

このスクリプトは NVM を自動的にダウンロードしてインストールします。

インストールの確認

シェルをリロードします:

source ~/.bashrc  # Bash ユーザーの場合
source ~/.zshrc   # Zsh ユーザーの場合

次に NVM のインストールを確認します:

nvm --version

バージョン番号が表示されるはずです。

インストールのトラブルシューティング

nvm: command not found というエラーが発生した場合:

  • ~/.bashrc または ~/.zshrc に以下の行があるか確認してください:
export NVM_DIR=""$HOME/.nvm""
[ -s ""$NVM_DIR/nvm.sh"" ] && . ""$NVM_DIR/nvm.sh""
  • これらの行を追加した後、シェルを再度リロードしてください。

ステップ 2: Node.js バージョンのインストールと管理

最新の Node.js バージョンをインストールする

最新の Node.js をインストールします:

nvm install node  # 最新リリース
nvm install --lts # 最新の長期サポート(LTS)バージョン

特定の Node.js バージョンをインストールする

特定の Node.js バージョン(例:20.11.0)を見つけてインストールします:

nvm ls-remote
nvm install 20.11.0

インストール済みバージョンの一覧表示

インストール済みの Node バージョンを確認します:

nvm ls

ステップ 3: Node.js バージョンの切り替え

Node.js バージョンを瞬時に切り替えます:

nvm use 20.11.0

アクティブなバージョンを確認します:

node -v

デフォルトの Node.js バージョンを設定する

新しいターミナル用のデフォルト Node.js を設定します:

nvm alias default 20.11.0

ステップ 4: プロジェクト固有のバージョンに .nvmrc を使用する

プロジェクトフォルダに .nvmrc ファイルを作成し、内部に Node バージョン(例:20.11.0)を記述します。その後、次のコマンドを使用します:

nvm use

NVM は .nvmrc ファイルからバージョンを自動的に選択します。

一般的な問題とクイックソリューション

Node バージョンが変更されない

  • 誤ってシステムにインストールされた Node.js を使用していないことを確認してください。
  • which node を実行して、NVM で管理されている Node がアクティブであることを確認します。
  • NVM コマンドや npm パッケージのインストールには 絶対に sudo を使用しないでください

バージョン切り替え後にグローバル npm パッケージが見つからない

各 Node.js バージョンは独自のグローバル npm パッケージを管理します。グローバルパッケージを移行するには:

nvm install 20 --reinstall-packages-from=18

""18"" を移行元の Node バージョンに置き換えてください。

NVM の更新

NVM をシームレスに更新するには、インストールスクリプトを再度実行します:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

これにより、インストール済みの Node バージョンに影響を与えることなく NVM が更新されます。

結論

NVM を使用することで、複数の Node.js 環境の管理が大幅に簡素化されます。素早い切り替えが可能になり、バージョンの競合を避け、Linux での開発ワークフローをスムーズに保ちます。

よくある質問

いいえ。NVM は Node.js バージョンをホームディレクトリにインストールするため、root 権限(`sudo`)は必要なく、使用すべきではありません。

NVM は macOS で完璧に動作します。Windows ユーザーは、類似しているが別のツールである NVM for Windows を使用する必要があります。

NVM セットアップの行がシェルプロファイル(`~/.bashrc`、`~/.zshrc`)にあることを確認し、シェルをリロードするかターミナルを再起動してください。

各ターミナルセッションでは、NVM で管理された異なる Node.js バージョンをアクティブにできますが、1つのセッションで実行できるバージョンは1つだけです。

Listen to your bugs 🧘, with OpenReplay

See how users use your app and resolve issues fast.
Loved by thousands of developers