NVM 完整介绍与使用指南 – wiki基地


NVM 完整介绍与使用指南

1. 什么是 NVM?

NVM(Node Version Manager)是一个命令行工具,允许你在同一台计算机上轻松安装、管理和切换不同版本的 Node.js。对于需要同时维护多个项目,或在不同 Node.js 版本之间进行测试和开发的开发者来说,NVM 是一个不可或缺的工具。它避免了因 Node.js 版本冲突而导致的环境问题。

2. 为什么使用 NVM?

使用 NVM 带来了多项显著优势:

  • 多版本共存: NVM 允许你的系统上同时安装多个 Node.js 版本。
  • 项目特定版本: 你可以为每个项目定义和使用特定的 Node.js 版本,确保开发环境的一致性,避免团队成员之间的版本差异问题。
  • 即时切换: 仅需一个简单的命令,即可在不同 Node.js 版本之间快速切换,无需手动卸载和重新安装。
  • 独立环境: 由 NVM 管理的每个 Node.js 版本都有其独立的全局 npm 包,有效避免了项目之间的包冲突。

3. 安装指南

NVM 的安装过程在 Linux/macOS(nvm-sh)和 Windows(nvm-windows)上略有不同。

准备工作:卸载现有 Node.js

在安装 NVM 之前,强烈建议卸载系统上任何已有的 Node.js 安装,以避免潜在的冲突。

3.1. 适用于 Linux 和 macOS (nvm-sh)

  1. 运行 NVM 安装脚本: 使用 curlwget 下载并运行安装脚本。请访问 nvm-sh 的 GitHub 仓库查看最新版本号,替换下面的 v0.39.7

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

    或者

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

  2. 更新配置文件: 安装脚本通常会自动将 NVM 的配置添加到你的 Shell 配置文件中(例如 ~/.bashrc~/.zshrc~/.profile~/.bash_profile)。

  3. 重新加载 Shell 配置: 安装完成后,重新加载你的终端配置以使 NVM 生效。

    bash
    source ~/.bashrc # 根据你使用的 Shell 选择对应的配置文件

  4. 验证安装: 打开一个新的终端窗口,并运行以下命令:

    bash
    nvm -v

    如果显示了 NVM 的版本号,则说明安装成功。

3.2. 适用于 Windows (nvm-windows)

NVM for Windows 是一个独立于 nvm-sh 的项目,专为 Windows 系统提供 Node.js 版本管理。

  1. 下载安装程序: 访问 nvm-windows 的 GitHub 仓库,找到 “Download Now” 链接。
  2. 选择 .exe 文件: 在发布页面下载最新版本的 nvm-setup.exe 文件。
  3. 完成安装向导: 运行下载的 .exe 文件,并按照安装提示完成安装。
  4. 验证安装: 打开一个新的命令提示符或 PowerShell 窗口,并运行:

    bash
    nvm -v

    如果显示了 NVM for Windows 的版本号,则说明安装成功。

4. NVM 基本使用命令

安装 NVM 后,你可以使用以下命令来管理 Node.js 版本:

  • nvm install <version>:安装特定版本的 Node.js。你可以指定完整的版本号(例如 18.17.1),主要版本(例如 20),或使用 latest 安装最新稳定版,使用 lts 安装最新的长期支持(LTS)版本。
    bash
    nvm install 18.17.1
    nvm install 20
    nvm install latest
    nvm install --lts

  • nvm use <version>:切换到已安装的特定 Node.js 版本。同样,你可以使用完整的版本号、主要版本,或使用 node(最新安装版本)或 lts(最新 LTS 版本)等别名。
    bash
    nvm use 18.17.1
    nvm use 20
    nvm use node
    nvm use --lts

  • nvm ls:列出所有已安装的 Node.js 版本。通常,当前正在使用的版本会用箭头或星号标记。

  • nvm ls-remote:列出所有可供安装的远程 Node.js 版本。

  • nvm current:显示当前正在使用的 Node.js 版本。

  • node -v:确认当前 Shell 中激活的 Node.js 版本。

  • nvm uninstall <version>:卸载特定版本的 Node.js。
    bash
    nvm uninstall 18.17.1

  • nvm alias <name> <version>:为特定 Node.js 版本创建别名。例如,nvm alias default 18.17.1 会将 18.17.1 设置为新 Shell 启动时的默认版本。

  • .nvmrc 文件:NVM 支持 .nvmrc 文件。你可以在项目的根目录创建一个名为 .nvmrc 的文件,并在其中写入项目所需的 Node.js 版本号。当你进入该项目目录时,如果配置得当,NVM 可以自动切换到指定的 Node.js 版本。

5. 总结

NVM 是一个强大而灵活的工具,极大地简化了 Node.js 版本的管理工作。无论你是开发人员、维护者还是需要处理多个 Node.js 项目的团队成员,NVM 都能帮助你保持开发环境的整洁和高效。通过掌握上述安装和使用指南,你将能够充分利用 NVM 的优势,提升你的开发体验。

滚动至顶部