Ubuntu下Node.js版本如何切换

Ubuntu下Node.js版本切换指南

在Ubuntu上管理Node.js版本，这事儿说简单也简单，说麻烦也麻烦。关键在于，你得选对工具。今天咱们就来聊聊几种主流的方法，帮你把这事儿理顺。

方法一 NVM推荐

先说结论：如果你需要在同一台机器上为不同项目维护不同的Node.js版本，那么Node Version Manager（NVM）几乎是首选方案。它按用户安装，完全不会污染系统的全局环境，用起来非常清爽。

• 安装或更新 NVM（Node Version Manager）
  • 第一步是获取安装脚本。通常使用curl或wget来下载执行。这里有个细节需要注意：脚本的版本号可能会更新，动手前最好去nvm-sh/nvm的官方仓库看一眼最新的版本号，然后把下面命令里的v0.39.5替换掉。

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

  • 安装完成后，脚本并不会立即生效。你需要重新加载一下当前的shell配置文件：

    source ~/.bashrc
    # 如果你用的是 zsh
    source ~/.zshrc

• 常用切换与管理命令
  • 安装指定版本非常简单，比如安装18.17.0或20.9.0，对应的npm也会自动装好：

    nvm install 18.17.0
    nvm install 20.9.0

  • 想切换到某个已经安装好的版本？一条命令的事儿：

    nvm use 18.17.0

  • 记不清自己装了哪些版本？用ls命令一目了然：

    nvm ls

  • 为了避免每次新开终端都要手动切换，可以设置一个默认版本：

    nvm alias default 18.17.0

  • 想直接上最新的长期支持（LTS）版本？也有快捷命令：

    nvm install --lts
    nvm use --lts

  • 有时候你只关心主版本号，比如就想用18.x系列的最新版，可以这样操作：

    nvm install 18
    nvm use 18

• 使用要点
  • 再强调一次，NVM是用户级别的工具。这意味着它的安装、版本切换都只影响当前用户，不会动到系统里其他用户或者全局的设置，特别适合个人开发机或者需要管理多项目环境的场景。

方法二 其他可选方案

当然，NVM并非唯一选择。根据你的具体需求，下面这几个方案也值得考虑。

• asdf 通用版本管理器
  • 如果你的技术栈不止Node.js，还需要管理Python、Ruby、Go等多种语言的版本，那么asdf这种通用版本管理器可能更合适。它用一个工具统一管理所有环境，避免了装一堆不同管理器的麻烦。

    # 安装 asdf（示例版本）
    git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.8.1
    echo '. ~/.asdf/asdf.sh' >> ~/.bashrc
    echo '. ~/.asdf/completions/asdf.bash' >> ~/.bashrc
    source ~/.bashrc
    
    # 安装 Node.js 插件
    asdf plugin-add nodejs https://github.com/asdf-vm/asdf-nodejs.git
    
    # 安装与切换
    asdf install nodejs 18.17.0
    asdf global nodejs 18.17.0 # 全局生效
    asdf local nodejs 16.20.2 # 仅对当前项目目录生效

• 系统仓库或 NodeSource 的 APT 安装
  • 有些朋友偏爱用系统的包管理器（如APT）来管理一切，觉得这样更统一、便于运维。你可以从Ubuntu官方仓库或NodeSource这样的第三方仓库安装。但需要注意的是，这种方式在版本切换上灵活性较差，通常需要卸载再安装，或者配置多个仓库源。

    # 示例：添加 NodeSource 的 14.x 仓库并安装
    curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -
    sudo apt-get install -y nodejs

• Docker 容器化
  • 对于追求极致环境隔离和可移植性的场景，Docker是终极武器。直接跑一个包含指定Node.js版本的容器，你的宿主机环境干干净净。

    docker run -it --rm -v $(pwd):/usr/src/app -w /usr/src/app node:18 bash

• 方案选择建议
  • 需要频繁在多个项目间切换Node.js版本？优先考虑NVM或asdf。
  • 更看重系统层面的统一管理和运维简便性？可以考虑NodeSource APT，但要接受其版本切换不够灵活的现实。
  • 强调环境隔离、复现和可移植？Docker方案不会让你失望。

常见问题与排查

工具用起来，难免会遇到些小坎儿。这里整理了几个典型问题，帮你快速排雷。

• 运行 nvm 提示 command not found
  • 这通常意味着nvm没有成功加载。首先，尝试手动执行source ~/.bashrc或source ~/.zshrc。其次，检查安装时是否把初始化脚本正确写入了你的shell配置文件。如果还不行，彻底关闭终端再重新打开，或者新开一个登录会话试试。
• 新开终端后，Node版本又变回旧的
  • 这说明你没有设置默认版本。解决方法是执行nvm alias default 来指定一个默认版本。或者，你也可以养成习惯，在每个新终端里显式地运行一次nvm use 。
• 权限错误（EACCES）或全局包安装异常
  • 使用NVM可以完美避开系统全局目录的权限问题。如果你用的是系统APT安装的Node.js，切记尽量不要用root权限运行npm。更好的做法是通过npm config set prefix来配置一个用户有写入权限的目录作为全局安装路径。
• 特定版本找不到或安装速度极慢
  • 网络问题有时会导致安装失败或缓慢。可以尝试为nvm或npm配置国内的镜像源。另外，优先选择LTS（长期支持）版本通常更容易成功。如果问题依旧，不妨考虑将nvm工具本身升级到最新版本，再重试安装命令。