如何在 Windows 上安装 Node Version Manager 0.39.5

简介

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

前置要求

Windows 操作系统
稳定的网络连接
管理员权限
基本的命令行操作知识
Windows 7或更高版本
Git (部分安装方法需要)

安装方法

使用Windows安装程序

1. 下载NVM for Windows安装程序

# 访问NVM for Windows的GitHub发布页面
https://github.com/coreybutler/nvm-windows/releases

下载最新的nvm-setup.zip文件。当前最新版本可能与0.39.5不同，请下载最新稳定版。

2. 运行安装程序

# 解压下载的zip文件
# 运行nvm-setup.exe

按照安装向导的提示进行安装。通常会安装到C:\Users\[用户名]\AppData\Roaming\nvm目录下。

3. 设置安装目录

# 在安装向导中选择NVM安装目录和Node.js符号链接目录

建议使用默认设置。NVM会自动将必要的路径添加到您的PATH环境变量中。

4. 完成安装

# 完成安装后，关闭并重新打开命令提示符或PowerShell

重新打开终端窗口以使环境变量生效。

通过Git安装（手动方法）

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

# 下载并安装Git for Windows
https://git-scm.com/download/win

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

# 需要使用nvm-windows

Windows用户应该使用nvm-windows，而不是原始的nvm。上述步骤不适用于Windows。

验证安装

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

在Windows上，您可能需要以管理员身份运行命令提示符或PowerShell来切换版本。

4. 设置默认Node.js版本

nvm alias default 16.20.0

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

基本使用示例

安装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配置文件中添加配置。请确保您已经添加了相应的配置，并重新加载配置文件或重启终端。

# 检查NVM是否正确安装
dir %USERPROFILE%\nvm

# 确保环境变量已设置，可能需要重启计算机

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

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

# 设置Node.js镜像站点
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

问题：切换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 0.39.5。现在您可以轻松地管理多个Node.js版本，根据项目需求随时切换。NVM为Node.js开发者提供了极大的灵活性，使您能够同时处理使用不同Node.js版本的项目，以及测试应用在不同版本下的兼容性。随着Node.js生态系统的不断发展，NVM将成为您工具箱中不可或缺的一部分。