🪽

nodebrew から nvm への移行手順(macOS)

2025/01/30に公開

Node.js のバージョン管理ツール nodebrew から nvm へ移行した手順と、移行時に検討した内容をまとめます。

nodebrew から nvm への移行手順(macOS)

Node.js のバージョン管理ツール nodebrew から nvm へ移行した手順と、移行時に検討した内容をまとめます。

移行の背景

個人開発で Firebase CLI を利用する際、Node.js のバージョンが古い旨の警告が表示されました。
これを機に、Node.js のバージョン管理ツールを nodebrew から nvm へ移行することを検討しました。

nvmnodebrew と比較して、以下の点で優位性があると考えました。

  • 普及率: nvm は Node.js バージョン管理ツールのデファクトスタンダードであり、情報量やコミュニティの規模で優位性がある。
  • 使用感: 一般的に nvm の方が直感的で使いやすいという意見が多い。

nodebrew に特に不満があったわけではありませんが、より一般的なツールである nvm への移行を試みることにしました。

nodebrew と nvm の比較

nodebrewnvm の主な違いを表にまとめます。

特徴 nodebrew nvm
開発言語 Perl シェルスクリプト
インストール方法 curl, git clone など curl, git clone など
コマンド nodebrew nvm
使用方法 やや複雑 直感的
普及率 nvm より低い 非常に高い
情報量 nvm より少ない 非常に多い
GitHub Stars 1.1k stars 81.9k stars
Windows対応 非公式の nodebrew-win が存在する 公式にはサポートされていない (代替ツールあり)
シェル対応 bash, zsh など bash, zsh, fish など

nodebrew から nvm への移行手順

具体的な移行手順は以下の通りです。

  1. nodebrew でインストール済みの Node.js を削除
  2. nodebrew 関連の設定を削除
  3. nvm をインストール
  4. nvm を使用して Node.js をインストール
  5. (オプション) グローバルパッケージの移行

1. nodebrew でインストール済みの Node.js を削除

まず、現在 nodebrew で管理している Node.js のバージョンを確認します。

nodebrew ls

インストール済みのバージョンがリスト表示されます。
次に、各バージョンをアンインストールします。

nodebrew uninstall v14.21.2
nodebrew uninstall v16.15.0
nodebrew uninstall v18.13.0
nodebrew uninstall v19.4.0
nodebrew uninstall v20.0.0
nodebrew uninstall v20.11.1

現在使用中のバージョンを none に設定し、current のシンボリックリンクを削除します。

nodebrew use none
nodebrew uninstall current

2. nodebrew 関連の設定を削除

シェルの設定ファイル (~/.zshrc, ~/.bashrc など) から nodebrew 関連の記述を削除またはコメントアウトします。

# export PATH=$HOME/.nodebrew/current/bin:$PATH

設定ファイルを再読み込みます。

source ~/.zshrc

3. nvm をインストール

nvm をインストールします。ここでは curl を使用します。
公式リポジトリ (https://github.com/nvm-sh/nvm) を参照し、最新バージョンを確認してください。
(2025年1月30日時点での最新バージョンは v0.40.1 です)

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

インストール後、シェル設定ファイルを再読み込みます。

source ~/.zshrc

nvm が正しくインストールされたか確認します。

command -v nvm

nvm と表示されればインストール成功です。

4. nvm を使用して Node.js をインストール

nvm を使用して Node.js をインストールします。
インストール可能なバージョンを確認します。

nvm ls-remote

LTS (Long Term Support) バージョンをインストールする場合は、以下のコマンドを実行します。

nvm install --lts

特定のバージョンを指定してインストールすることも可能です。

nvm install v22.13.1

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

nvm ls

使用する Node.js のバージョンを指定します。

nvm use v22.13.1

5. (オプション) グローバルパッケージの移行

nodebrew 環境でインストールしていたグローバルパッケージを nvm 環境に移行する必要がある場合は、別途インストール作業が必要です。

例:yarn をグローバルインストールする場合

npm install -g yarn

移行後の所感

nvm への移行作業は比較的スムーズに完了しました。
nvm のコマンド体系は直感的で、バージョン切り替えやインストールが容易に行えます。
情報量が多い点も、今後トラブルが発生した際に役立つと考えられます。

nodebrew から nvm への移行は必須ではありませんが、より汎用的なツールへ移行するメリットはあると感じました。

まとめ

nodebrew から nvm への移行手順と、移行時の検討事項についてまとめました。
本記事が、同様の移行を検討されている方の参考になれば幸いです。

Discussion