Node.js 在 Linux 上如何進行版本控制

Node.js 在 Linux 上的版本控制方法

在 Linux 系統中，管理 Node.js 版本的核心需求是多版本共存與靈活切換，以滿足不同項目的兼容性要求。以下是常用的版本控制工具及操作指南：

1. 使用 nvm（Node Version Manager）

nvm 是 Linux 下最流行的 Node.js 版本管理工具，支持安裝、切換、卸載多個版本，且隔離性好。

• 安裝 nvm：
  運行以下命令安裝最新版 nvm（以 v0.39.5 為例）：

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

  安裝完成后，重新加載 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）使 nvm 生效：

  source ~/.bashrc
  

  驗證安裝：nvm --version（顯示版本號即成功）。
• 常用操作：
  • 安裝指定版本：nvm install <version>（如 nvm install 18.17.1）；
  • 切換版本：nvm use <version>（如 nvm use 16.20.2）；
  • 設置默認版本：nvm alias default <version>（如 nvm alias default 18.17.1，新終端默認使用該版本）；
  • 列出已安裝版本：nvm ls（帶 -> 的為當前使用版本）；
  • 卸載版本：nvm uninstall <version>（如 nvm uninstall 14.21.3）。
• 項目級版本控制：
  在項目根目錄創建 .nvmrc 文件，寫入所需版本號（如 18.17.1）。進入項目目錄時，運行 nvm use 會自動切換到該版本。

2. 使用 n（Node Version Switcher）

n 是一個輕量級版本管理工具，基于 npm 安裝，操作簡單，適合快速切換版本。

• 安裝 n：
  需先確保系統安裝了 Node.js（通過包管理器或 nvm），然后全局安裝 n：

  sudo npm install -g n
  

• 常用操作：
  • 安裝版本：n <version>（如 n 16.20.2）或 n latest（安裝最新版）、n lts（安裝 LTS 版）；
  • 切換版本：運行 n 命令，會列出所有已安裝版本，輸入對應數字選擇；
  • 卸載版本：n - <version>（如 n - 14.21.3）。
• 注意：n 會將版本安裝在 /usr/local/n/versions/node 目錄下，切換版本時修改符號鏈接。

3. 使用 asdf

asdf 是通用語言版本管理工具（支持 Node.js、Python、Ruby 等），通過插件擴展功能，適合需要管理多語言環境的用戶。

• 安裝 asdf：
  克隆 asdf 倉庫并添加到 shell 配置文件（如 ~/.bashrc）：

  git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.10.0
  echo -e '\n. $HOME/.asdf/asdf.sh' >> ~/.bashrc
  echo -e '\n. $HOME/.asdf/completions/asdf.bash' >> ~/.bashrc
  source ~/.bashrc
  

• 安裝 Node.js 插件：

  asdf plugin-add nodejs
  

• 常用操作：
  • 安裝版本：asdf install nodejs <version>（如 asdf install nodejs 18.17.1）；
  • 切換版本：asdf global nodejs <version>（全局使用）或 asdf local nodejs <version>（項目級，創建 .tool-versions 文件記錄版本）；
  • 列出版本：asdf list nodejs；
  • 卸載版本：asdf uninstall nodejs <version>。

4. 使用 volta

volta 是現代 JavaScript 工具鏈管理器，支持 Node.js 和 npm 版本管理，特點是自動切換（根據項目配置）和快速安裝。

• 安裝 volta：
  運行以下命令安裝：

  curl https://get.volta.sh | bash
  

  安裝完成后，重新加載 shell 配置文件。
• 常用操作：
  • 安裝版本：volta install node@<version>（如 volta install node@16.20.2）；
  • 切換版本：volta pin node@<version>（在項目目錄運行，自動創建 .volta 目錄記錄版本）；
  • 查看版本：volta list node；
  • 卸載版本：volta uninstall node@<version>。

注意事項

• 權限問題：避免使用 sudo 安裝 Node.js 或版本管理工具（除非必要），防止權限沖突；
• 項目一致性：建議在項目根目錄使用 .nvmrc、.tool-versions 或 package.json 記錄 Node.js 版本，確保團隊成員或部署環境使用相同版本；
• 工具選擇：nvm 適合純 Node.js 環境，asdf 適合多語言用戶，volta 適合追求簡潔的現代開發者。