😺
windows環境で複数バージョンのnodejsを使えるように最新のasdfを導入するための手順
はじめに
WindowsでNode.jsの複数バージョンを管理するために、WSL (Windows Subsystem for Linux) とasdfを使用する方法を紹介します。asdfは様々なプログラミング言語やツールのバージョン管理を一元化できる便利なツールです。
前提条件
- Windows 10バージョン2004以降、またはWindows 11
- 管理者権限を持つWindowsアカウント
- PowerShellの基本的な操作知識
- 最低8GBのRAM
- 仮想化が有効化されているBIOS設定
- Linuxの基本的な操作知識
本記事の想定バージョン
- Windows 11 pro
- WSL 2
- Ubuntu 24.04
- asdf 0.16.5
1. asdf導入手順
1. WSLを有効化する
Windows PowerShellを管理者として実行し、以下のコマンドを実行します
Windows PowerShell（管理者）
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
実行後、PCを再起動してください。
2. Ubuntuをインストールする
PowerShellで以下のコマンドを実行します
Windows PowerShell
wsl --install ubuntu-24.04
インストール後、Ubuntuを起動してユーザー名とパスワードを設定します。
Windows PowerShell
# wslの既定のディストリビューションを起動
wsl
# 複数ある場合等では指定したディストリビューションで起動する
wsl -d ubuntu-24.04
3. Ubuntuにhomebrewをインストールする
Ubuntu
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
4. homebrewのパスを通す
各ユーザーごとに反映されるため、複数ユーザーで使用する場合はそれぞれのユーザーで以下のコマンドを実行する必要があります
Ubuntu
echo >> ~/.bashrc
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
# .bashrcを再読み込み
source ~/.bashrc
5. asdfをインストールする
Ubuntu
brew install asdf
6. asdfのパスを通す
各ユーザーごとに反映されるため、複数ユーザーで使用する場合はそれぞれのユーザーで以下のコマンドを実行する必要があります
Ubuntu
echo -e '\n. /home/linuxbrew/.linuxbrew/opt/asdf/libexec/asdf.sh' >> ~/.bashrc
# .bashrcを再読み込み
source ~/.bashrc
7. Node.js用の依存関係をインストールする
Ubuntu
sudo apt-get update
sudo apt-get install dirmngr gpg curl gawk
8. Node.jsプラグインのインストール
Ubuntu
asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
2. Node.jsのインストールと使用方法について
特定のバージョンをインストールする場合
Ubuntu
# 最新のLTSバージョンをインストール
asdf install nodejs lts
# 特定のバージョンをインストール（例：16.14.0）
asdf install nodejs 16.14.0
指定したバージョンをセットする
Ubuntu
cd プロジェクトディレクトリ
asdf set nodejs 16.14.0
3. バージョンの確認方法
現在使用中のバージョンを確認
Ubuntu
asdf current nodejs
インストール済みのバージョンを確認
Ubuntu
asdf list nodejs
利用可能なバージョンを確認
Ubuntu
asdf list all nodejs
最新の安定版を確認
Ubuntu
asdf latest nodejs
トラブルシューティング
パスが通っていない場合
.bashrcの内容が正しく読み込まれていない場合は、ターミナルを再起動するか、以下のコマンドを実行してください
Ubuntu
source ~/.bashrc
Node.jsのインストールに失敗する場合
依存関係が不足している可能性があります。以下のコマンドで追加の依存パッケージをインストールしてください
Ubuntu
sudo apt-get install build-essential
まとめ
以上の手順で、Windows環境でWSLとasdfを使用してNode.jsの複数バージョンを管理できるようになります。asdfは他の言語やツールのバージョン管理にも使用できるので、必要に応じて他のプラグインも追加してみてください。
Discussion