Ubuntu 安裝 Node.js 的兩種最佳實踐方式
在 Ubuntu 系統中,Node.js 其實已經存在於官方套件庫中,可以直接透過 apt 安裝。但這個版本通常落後於官方最新版本
若希望取得最新版或方便切換多版本,建議使用以下兩種方式之一
方法一:使用 NodeSource(官方建議的 APT 外部庫)
這是最常見的「系統層級」安裝方式,由 NodeSource 提供編譯好的二進制檔。
它能讓你直接透過 apt 安裝最新的穩定版 Node.js。
官方來源參考: distributions/DEV_README.md (目前已經改版網址不是 setup_24.x 但是有向前兼容仍然可用,我更喜歡有明確寫出版本文章就不改了)
步驟:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm -v
優點:
- 系統層級安裝,所有使用者可共用。
- 可與 Ubuntu 的自動更新整合。
- 適合伺服器、CI/CD 環境。
缺點:
- 升級node版本需使用
sudo。 - 若需多版本切換(例如 Node 16 與 22 共存)不方便。
對於安裝全域套件預設會在系統目錄中,依照官方指示可以改到當前使用者層級中
mkdir -p ~/.local/bin
npm config set prefix ~/.local
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm config get prefix
設置好可以安裝牛牛測試一下
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
步驟:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
\. "$HOME/.nvm/nvm.sh"
nvm install 24
node -v
npm -v
優點:
- 不需
sudo 權限即可安裝。 - 可快速切換 Node.js 版本。
- npm 安裝時自動位於使用者目錄(例如
~/.npm),更安全。
缺點:
- 只對目前使用者有效。
- 系統服務(如 systemd)不會直接使用 NVM 環境。