在 WSL 上安裝 NVM：輕鬆管理你的 Node.js 版本，並安裝 Gemini CLI

在 Windows 上做開發，WSL (Windows Subsystem for Linux) 已經是許多人的標配。當你需要處理不同專案，而這些專案又依賴不同版本的 Node.js 時，版本管理就成了一個頭痛的問題。

這時候，NVM (Node Version Manager) 就是你的好幫手！它是一個命令列工具，可以讓你輕鬆地安裝、切換和管理多個 Node.js 版本。這篇文章將帶你一步步在 WSL 環境中安裝並設定 NVM。

步驟一：安裝 NVM

首先，我們需要從 NVM 的官方 GitHub 儲存庫安裝它。建議先到 NVM GitHub Releases 頁面查看最新的版本號，以確保你安裝的是最新版本。

在本次教學中，我們以 v0.40.3 為例。打開你的 WSL 終端機，貼上並執行以下指令：

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

這個指令會下載安裝腳本並自動執行。

安裝完成後，NVM 的安裝腳本通常會自動嘗試將設定加入你的 shell 設定檔（例如 ~/.bashrc 或 ~/.zshrc）。為了確保 NVM 能夠在每次打開新終端機時自動載入，我們來手動檢查並設定它。

你可以先執行以下指令，讓 NVM 在目前的終端機 session 中生效：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

為了讓設定永久生效，你需要將這段設定碼加入你的 shell 設定檔。

如果你使用 Bash (預設):

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
source ~/.bashrc

如果你使用 Zsh (例如搭配 Oh My Zsh):

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
source ~/.zshrc

完成後，可以執行 nvm --version 來確認是否安裝成功。如果成功，它會顯示 NVM 的版本號。

現在 NVM 已經準備就緒，讓我們來安裝 Node.js 吧！

LTS (Long-Term Support) 版本是官方長期支援的版本，通常也是最穩定、最推薦用於生產環境的版本。你可以用以下指令查看所有可用的 LTS 版本：

nvm ls-remote --lts

如果你想直接安裝最新的 LTS 版本，指令非常簡單：

nvm install --lts

NVM 會自動幫你下載、編譯並安裝。

假設你已經安裝了多個 Node.js 版本，你可以使用 nvm use 指令來切換。

# 切換到指定的 22.17.0 版本
nvm use 22.17.0

你也可以使用 nvm ls 來查看目前已經安裝了哪些版本，以及正在使用的是哪一個。

安裝好 Node.js 和 npm 後，你就可以開始安裝各種強大的工具了。例如，我們可以來安裝 Google Gemini 的命令列工具：

npm install -g @google/gemini-cli

一個有趣的小提示：在 WSL 環境中，當你執行需要 Google 帳號驗證的指令時，它一樣會自動幫你打開 Windows 上的預設瀏覽器來完成驗證流程，整個體驗非常流暢！

現在，你已經掌握了在 WSL 中使用 NVM 的技巧，再也不用為 Node.js 的版本問題煩惱了！