Ubuntu下Node.js版本如何切换

首页

编程语言

热心网友

转载

2026-04-26

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工具本身升级到最新版本，再重试安装命令。