TopGuides！

如何在 Linux 上安装 Node Version Manager 0.39.5

简介

本教程将指导您如何在 linux 系统上安装 NVM (Node Version Manager) 0.39.5。NVM 是一个流行的 Node.js 版本管理工具，允许您在同一台计算机上安装和使用多个版本的 Node.js。这对于开发不同需要不同 Node.js 版本的项目非常有用，同时也方便您测试您的应用在不同 Node.js 版本下的兼容性。

前置要求

  • Linux 操作系统
  • 稳定的网络连接
  • 管理员权限（用于执行sudo命令）
  • 基本的命令行操作知识
  • 任何现代Linux发行版
  • curl或wget (用于下载安装脚本)
  • Git (部分安装方法需要)

安装方法

使用安装脚本（推荐）

1. 使用curl安装

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

这将下载并运行NVM的安装脚本。脚本会克隆NVM仓库到~/.nvm目录，并添加必要的配置到您的shell配置文件中。

2. 使用wget安装（可选）

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

如果您没有curl，可以使用wget代替。功能与curl方法相同。

3. 加载NVM

# 在新的终端窗口中运行，或者运行以下命令
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm bash_completion

安装脚本会自动将这些命令添加到您的shell配置文件（~/.bashrc、~/.zshrc等）中。您需要重新加载配置文件或打开新的终端窗口以使其生效。

使用包管理器安装（特定发行版）

1. Ubuntu/Debian (使用APT)

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

这将安装curl（如果尚未安装）并使用NVM安装脚本。

2. CentOS/RHEL/Fedora (使用YUM/DNF)

sudo yum install curl
# 或使用dnf
sudo dnf install curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

这将安装curl（如果尚未安装）并使用NVM安装脚本。

3. Arch Linux (使用Pacman)

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

这将安装curl（如果尚未安装）并使用NVM安装脚本。

通过Git安装（手动方法）

1. 安装Git（如果尚未安装）

sudo apt install git  # Debian/Ubuntu
# 或
sudo yum install git  # CentOS/RHEL

Git是版本控制系统，用于克隆NVM仓库。

2. 克隆NVM仓库

git clone https://github.com/nvm-sh/nvm.git ~/.nvm

这将NVM仓库克隆到您的主目录下的.nvm文件夹中。

3. 检出最新版本

cd ~/.nvm
git checkout v0.39.5

请根据最新版本调整版本号。当前最新稳定版本可能与0.39.5不同。

4. 激活NVM

# 将以下内容添加到您的shell配置文件(.bashrc, .zshrc等)中
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm bash_completion

添加这些配置后，重新加载配置文件或打开新的终端窗口以使其生效。

验证安装

1. 验证NVM是否成功安装

nvm --version

如果NVM成功安装，这将显示NVM的版本号。

2. 安装Node.js

# 安装最新的LTS版本
nvm install --lts

# 或安装特定版本
nvm install 16.20.0

您可以安装多个不同版本的Node.js。

3. 切换Node.js版本

# 使用已安装的特定版本
nvm use 16.20.0

# 或使用最新的LTS版本
nvm use --lts

切换版本后，可以使用`node -v`验证当前使用的Node.js版本。

4. 设置默认Node.js版本

nvm alias default 16.20.0

这将设置一个默认的Node.js版本，每次打开新终端时都会自动使用该版本。

5. 检查配置文件

cat ~/.bashrc | grep nvm
# 或
cat ~/.zshrc | grep nvm

确认NVM配置已添加到您的shell配置文件中。

基本使用示例

安装Node.js版本

NVM可以安装任何可用的Node.js版本。

# 安装最新的LTS（长期支持）版本
nvm install --lts

# 安装最新版本
nvm install node

# 安装特定版本
nvm install 14.17.0
nvm install 16.20.0
nvm install 18.16.0

NVM允许您在同一台计算机上安装和管理多个Node.js版本。您可以安装特定版本、最新版本或长期支持(LTS)版本。

查看已安装的Node.js版本

查看已使用NVM安装的所有Node.js版本。

# 列出所有已安装的版本
nvm ls

# 列出所有可以安装的版本(这可能会产生很长的列表)
nvm ls-remote

# 列出所有可用的LTS版本
nvm ls-remote --lts

使用`nvm ls`命令可以查看本地已安装的所有Node.js版本，当前使用的版本会标有箭头标记。使用`nvm ls-remote`可以查看远程可用的所有版本。

切换Node.js版本

在已安装的Node.js版本之间切换。

# 使用特定版本
nvm use 16.20.0

# 使用最新的LTS版本
nvm use --lts

# 使用最新版本
nvm use node

# 验证当前使用的版本
node -v

使用`nvm use`命令可以临时切换当前终端会话使用的Node.js版本。如果您打开新的终端窗口，可能需要再次使用此命令，除非您设置了默认版本。

设置默认Node.js版本

设置每次打开新终端时自动使用的Node.js版本。

# 将特定版本设置为默认版本
nvm alias default 16.20.0

# 将最新的LTS版本设置为默认版本
nvm alias default "lts/*"

# 查看所有别名
nvm alias

通过设置默认版本，您可以确保每次打开新终端窗口时都会自动使用您指定的Node.js版本，而不需要每次都运行`nvm use`命令。

创建和使用别名

为常用的Node.js版本创建别名。

# 创建一个别名
nvm alias myapp 14.17.0

# 使用别名
nvm use myapp

# 删除别名
nvm unalias myapp

别名可以让您为特定的Node.js版本指定一个易记的名称，特别适合为不同的项目使用不同的Node.js版本。

在项目中固定Node.js版本

在项目目录中创建.nvmrc文件，指定项目使用的Node.js版本。

# 创建.nvmrc文件
echo "16.20.0" > .nvmrc

# 使用.nvmrc中指定的版本
nvm use

# 安装.nvmrc中指定的版本（如果尚未安装）
nvm install

通过在项目根目录创建.nvmrc文件，您可以为项目指定特定的Node.js版本。当您使用`nvm use`(不带参数)命令时，NVM会读取.nvmrc文件并切换到指定的版本。这在团队协作和CI/CD环境中特别有用。

卸载Node.js版本

卸载不再需要的Node.js版本。

# 卸载特定版本
nvm uninstall 14.17.0

# 卸载当前版本
nvm uninstall current

如果您不再需要某个Node.js版本，可以使用`nvm uninstall`命令将其卸载，释放磁盘空间。

运行特定版本的Node.js

在不切换当前版本的情况下，使用特定版本运行命令。

# 使用特定版本运行脚本
nvm exec 16.20.0 node script.js

# 使用特定版本运行npm命令
nvm exec 16.20.0 npm install

`nvm exec`命令允许您在不改变当前活动版本的情况下，使用特定版本的Node.js运行命令。这对于测试脚本在不同Node.js版本下的兼容性非常有用。

常见问题

问题：nvm command not found

解决方案：确保软件已正确安装并添加到系统PATH中。可能需要重启终端或系统。

问题：安装过程中遇到权限错误

解决方案：确保您有管理员权限。在Windows上以管理员身份运行命令提示符，在Mac/Linux上使用sudo。

问题：安装后无法使用nvm命令

解决方案：NVM需要在shell配置文件中添加配置。请确保您已经添加了相应的配置，并重新加载配置文件或重启终端。

# 将以下内容添加到您的shell配置文件(.bashrc, .zshrc等)中
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # 加载nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # 加载nvm bash_completion

# 重新加载配置文件
source ~/.bashrc  # 或 source ~/.zshrc

问题：nvm安装Node.js时报网络错误

解决方案：这可能是由于网络连接问题或Node.js镜像站点无法访问。您可以尝试设置镜像站点或使用代理。

# 设置Node.js镜像站点
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

# 或者在~/.bashrc或~/.zshrc中添加
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

问题：切换Node.js版本后npm全局包不可用

解决方案：每个Node.js版本都有自己的全局npm包。您需要为每个版本单独安装全局包，或者使用nvm的别名功能。

# 为当前使用的Node.js版本安装全局包
npm install -g <package-name>

# 或使用nvm alias设置默认版本
nvm alias default <version>

问题：Windows上安装后找不到node或npm命令

解决方案：在Windows上，您需要使用nvm use命令来激活特定版本的Node.js。

# 列出所有安装的Node.js版本
nvm list

# 使用特定版本的Node.js
nvm use <version>

使用技巧

使用.nvmrc文件进行项目版本管理

在每个项目的根目录创建一个.nvmrc文件，并在其中指定项目使用的Node.js版本。这样，每次进入项目目录时，只需运行`nvm use`命令即可自动切换到正确的Node.js版本。

为不同项目创建别名

使用`nvm alias`创建项目特定的别名，例如`nvm alias projectA 14.17.0`和`nvm alias projectB 16.20.0`，这样可以使用`nvm use projectA`快速切换到对应的Node.js版本。

配置自动版本切换

在shell配置文件(.bashrc, .zshrc等)中添加一个自动切换版本的函数，在进入包含.nvmrc文件的目录时自动运行`nvm use`。例如： ``` autoload -U add-zsh-hook load-nvmrc() { local node_version="$(nvm version)" local nvmrc_path="$(nvm_find_nvmrc)" if [ -n "$nvmrc_path" ]; then local nvmrc_node_version=$(nvm version "$(cat "${nvmrc_path}")") if [ "$nvmrc_node_version" = "N/A" ]; then nvm install elif [ "$nvmrc_node_version" != "$node_version" ]; then nvm use fi elif [ "$node_version" != "$(nvm version default)" ]; then nvm use default fi } add-zsh-hook chpwd load-nvmrc load-nvmrc ```

使用镜像加速下载

如果从官方源下载Node.js速度较慢，可以设置镜像站点。对于Unix/Linux/macOS：`export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node`；对于Windows：`nvm node_mirror https://npmmirror.com/mirrors/node/`。

安装最新版与保持稳定

使用`nvm install --lts`安装最新的LTS版本，这通常是最稳定的版本，适合生产环境。使用`nvm install node`安装最新版本，通常包含最新特性，但可能没有LTS版本稳定。

管理全局npm包

每个Node.js版本都有自己的全局npm包集。当切换Node.js版本时，您可能需要重新安装常用的全局包。可以创建一个脚本来自动安装常用的全局包： ``` # 安装常用全局包 npm install -g npm yarn typescript eslint prettier ```

清理缓存

如果遇到安装问题，尝试清理NVM缓存：`nvm cache clear`。对于nvm-windows，可以删除`%AppData%\nvm\cache`目录中的内容。

使用NVM进行持续集成

在CI/CD环境中，可以使用NVM确保构建始终使用正确的Node.js版本。通常只需在CI配置中添加安装NVM的步骤，然后从项目的.nvmrc文件加载版本： ``` curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash export NVM_DIR="$HOME/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" nvm install npm ci ```

迁移全局包

使用`nvm reinstall-packages`命令可以将全局包从一个版本迁移到另一个版本：`nvm install 16.20.0 --reinstall-packages-from=14.17.0`这会安装16.20.0版本并迁移所有从14.17.0版本安装的全局包。

相关资源

NVM官方文档

NVM的官方GitHub仓库，包含详细的安装和使用文档。

NVM for Windows

Windows版本的NVM，提供了与原始NVM类似的功能。

Node.js官方网站

Node.js的官方网站，提供各版本的下载和文档。

Node.js发行时间表

Node.js的发布日程表，显示各版本的支持期限和状态。

NPM文档

npm包管理器的官方文档，随Node.js一起安装。

NVM使用教程 - DigitalOcean

DigitalOcean的详细教程，介绍如何使用NVM安装和管理Node.js。

使用NVM管理多个Node.js版本

LogRocket博客上的详细指南，介绍如何使用NVM管理多个Node.js版本。

Node.js最佳实践

一个包含Node.js最佳实践的综合指南，帮助您充分利用不同版本的Node.js。

总结

恭喜！您已成功安装并配置了NVM 0.39.5。现在您可以轻松地管理多个Node.js版本，根据项目需求随时切换。NVM为Node.js开发者提供了极大的灵活性，使您能够同时处理使用不同Node.js版本的项目，以及测试应用在不同版本下的兼容性。随着Node.js生态系统的不断发展，NVM将成为您工具箱中不可或缺的一部分。