nodebrew から nvm への移行手順(macOS)
Node.js のバージョン管理ツール nodebrew から nvm へ移行した手順と、移行時に検討した内容をまとめます。
nodebrew から nvm への移行手順(macOS)
Node.js のバージョン管理ツール nodebrew
から nvm
へ移行した手順と、移行時に検討した内容をまとめます。
移行の背景
個人開発で Firebase CLI を利用する際、Node.js のバージョンが古い旨の警告が表示されました。
これを機に、Node.js のバージョン管理ツールを nodebrew
から nvm
へ移行することを検討しました。
nvm
は nodebrew
と比較して、以下の点で優位性があると考えました。
-
普及率:
nvm
は Node.js バージョン管理ツールのデファクトスタンダードであり、情報量やコミュニティの規模で優位性がある。 -
使用感: 一般的に
nvm
の方が直感的で使いやすいという意見が多い。
nodebrew
に特に不満があったわけではありませんが、より一般的なツールである nvm
への移行を試みることにしました。
nodebrew と nvm の比較
nodebrew
と nvm
の主な違いを表にまとめます。
特徴 | 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 への移行手順
具体的な移行手順は以下の通りです。
- nodebrew でインストール済みの Node.js を削除
- nodebrew 関連の設定を削除
- nvm をインストール
- nvm を使用して Node.js をインストール
- (オプション) グローバルパッケージの移行
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