Ubuntu 安裝 Node.js 的兩種最佳實踐方式

在 Ubuntu 系統中，Node.js 其實已經存在於官方套件庫中，可以直接透過 apt 安裝。但這個版本通常落後於官方最新版本

若希望取得最新版或方便切換多版本，建議使用以下兩種方式之一

方法一：使用 NodeSource（官方建議的 APT 外部庫）

這是最常見的「系統層級」安裝方式，由 NodeSource 提供編譯好的二進制檔。
它能讓你直接透過 apt 安裝最新的穩定版 Node.js。

官方來源參考： distributions/DEV_README.md  (目前已經改版網址不是 setup_24.x 但是有向前兼容仍然可用，我更喜歡有明確寫出版本文章就不改了)

步驟：

# 加入 NodeSource 官方提供的最新 Node.js 安裝腳本（以 24.x 為例）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# 安裝 Node.js 與 npm
sudo apt install -y nodejs

# 驗證版本
node -v
npm -v

優點：

• 系統層級安裝，所有使用者可共用。
• 可與 Ubuntu 的自動更新整合。
• 適合伺服器、CI/CD 環境。

缺點：

• 升級node版本需使用 sudo。
• 若需多版本切換（例如 Node 16 與 22 共存）不方便。

對於安裝全域套件預設會在系統目錄中，依照官方指示可以改到當前使用者層級中

# 1. 建立目錄
mkdir -p ~/.local/bin

# 2. 設定 npm prefix
npm config set prefix ~/.local

# 3. 加 PATH 到 bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

# 4. 載入設定
source ~/.bashrc

# 5. 驗證
npm config get prefix
# 應該顯示: /home/chg/.local

設置好可以安裝牛牛測試一下

npm install -g cowsay && cowsay "免 sudo 成功！"

或是安裝 claude code

npm install -g @anthropic-ai/claude-code

方法二：使用 NVM（Node Version Manager）

這是由社群維護的 Node.js 版本管理器，能讓你以使用者身份安裝 Node.js（非系統層級）。
適合開發者或有多專案需求的環境。

官方來源參考： nvm-sh/nvm GitHub Repository

步驟：

# 下載並安裝 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 不想重新啟動 shell 時，執行：
\. "$HOME/.nvm/nvm.sh"

# 下載並安裝 Node.js：
nvm install 24

# 核對板本：
node -v # Should print "v24.10.0".
npm -v # 應會印出 "11.6.1"。

優點：

• 不需 sudo 權限即可安裝。
• 可快速切換 Node.js 版本。
• npm 安裝時自動位於使用者目錄（例如 ~/.npm），更安全。

缺點：

• 只對目前使用者有效。
• 系統服務（如 systemd）不會直接使用 NVM 環境。