nvm完全指南：轻松管理Node.js版本 – wiki词典

作者： /

nvm完全指南：轻松管理Node.js版本

前言

在现代Web开发中，Node.js扮演着至关重要的角色。然而，不同的项目可能依赖于不同版本的Node.js，这给开发者带来了不小的挑战。频繁地卸载和安装特定版本的Node.js不仅耗时，而且容易出错。幸运的是，我们有NVM（Node Version Manager），一个能让我们在同一台机器上轻松安装、切换和管理多个Node.js版本的强大工具。

本指南将详细介绍如何安装、配置和使用nvm，帮助你彻底告别Node.js版本管理的烦恼。

什么是nvm？

NVM (Node Version Manager) 是一个命令行工具，它允许你在系统中维护多个独立的Node.js版本。你可以根据项目需求，随时通过一条简单的命令切换到对应的Node.js环境，而不会相互干扰。

使用nvm的主要优势：

  • 隔离环境： 为每个项目设置独立的Node.js版本，避免版本冲突。
  • 高效切换： 只需一条命令即可在不同版本间快速切换。
  • 简化升级： 测试新版Node.js变得异常简单，无需担心破坏现有环境。
  • 易于安装： 可以轻松安装任何你需要的Node.js版本，包括长期支持版（LTS）和最新版。

安装nvm

在安装nvm之前，强烈建议先卸载系统中已有的Node.js，以避免潜在的路径冲突和管理混乱。

在Windows上安装

Windows用户使用的是一个由社区维护的独立版本 nvm-windows。

  1. 下载安装包：
    访问 nvm-windows的GitHub发布页面，下载最新版本的 nvm-setup.zip 或 nvm-setup.exe。

  2. 运行安装程序：
    解压并运行安装程序。安装向导会引导你完成以下两个关键路径的设置：

    • NVM安装路径： 这是nvm自身的安装位置（例如 C:\nvm）。
    • Node.js代理路径： 这是nvm用来存放和管理不同Node.js版本的目录（例如 C:\nodejs）。建议选择不包含中文或空格的路径。

  3. 验证安装：
    安装完成后，打开一个新的命令提示符（CMD）或PowerShell窗口，输入以下命令：

    bash
    nvm version

    如果成功安装，将显示nvm的版本号，说明nvm已准备就绪。

在macOS或Linux上安装

macOS和Linux用户可以使用官方提供的shell脚本进行安装。

  1. 运行安装脚本：
    打开终端，执行以下命令之一：

    “`bash

    使用curl

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

    使用wget

    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
    “`
    (注意： v0.39.7是编写本指南时的最新版本，你可以随时在nvm的GitHub页面上找到最新的版本号。)

  2. 配置环境变量：
    安装脚本会自动尝试将nvm的配置信息添加到你的shell配置文件中（如 ~/.bashrc, ~/.zshrc, ~/.profile 等）。为了让配置立即生效，请关闭并重新打开终端，或者执行以下命令：

    “`bash

    如果你使用bash

    source ~/.bashrc

    如果你使用zsh

    source ~/.zshrc
    “`

  3. 验证安装：
    在新的终端窗口中，输入：

    bash
    nvm --version

    如果返回版本号，则表示安装成功。

配置国内镜像源（加速下载）

由于网络原因，直接从官方源下载Node.js可能会很慢。建议配置国内的镜像源来提升下载速度。

  • 对于Windows用户：
    找到nvm安装目录下的 settings.txt 文件，在文件末尾添加以下两行：

    node_mirror: https://npmmirror.com/mirrors/node/
    npm_mirror: https://npmmirror.com/mirrors/npm/

  • 对于macOS/Linux用户：
    在终端执行以下命令，将其添加到你的shell配置文件中：

    bash
    export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
    然后执行 source ~/.bashrc 或 source ~/.zshrc 使其生效。

nvm常用命令

掌握以下常用命令，你就能自如地管理Node.js版本。

  • nvm install <version>：安装指定版本
    这是最核心的命令。你可以指定具体版本号，也可以使用别名。

    “`bash

    安装指定版本

    nvm install 18.17.1

    安装最新的LTS（长期支持）版本

    nvm install –lts

    安装最新稳定版

    nvm install stable
    “`

  • nvm use <version>：切换Node.js版本
    此命令用于在当前shell会话中切换到指定的Node.js版本。

    bash
    nvm use 18.17.1
    切换后，可以通过 node -v 和 npm -v 来验证。

  • nvm list 或 nvm ls：列出已安装的版本
    此命令会显示所有已安装的Node.js版本，并在当前使用的版本前用星号 (*) 标记。

  • nvm list available：列出所有可供安装的版本
    如果你不确定需要哪个版本，可以用这个命令查看所有可用的远程版本。

  • nvm uninstall <version>：卸载指定版本
    当某个版本不再需要时，可以用此命令将其卸载。

    bash
    nvm uninstall 16.10.0

  • nvm alias default <version>：设置默认版本
    每次打开新的终端时，nvm会自动使用这个默认版本。

    bash
    nvm alias default 18.17.1

  • nvm current：显示当前版本
    快速查看当前正在使用的Node.js版本。

项目级版本管理：.nvmrc

为了确保团队成员使用统一的Node.js版本，你可以在项目根目录下创建一个名为 .nvmrc 的文件，文件内容仅包含所需的版本号。

例如，在项目根目录创建 .nvmrc 文件，并写入：

18.17.1

当你进入该项目目录后，只需执行以下命令，nvm就会自动读取 .nvmrc 文件并切换到指定的版本。如果该版本尚未安装，它还会提示你进行安装。

bash
nvm use
很多shell（如zsh）的插件可以配置为进入目录时自动执行 nvm use，实现无缝切换。

结语

NVM是一个看似简单却功能强大的工具，它彻底解决了Node.js版本管理的痛点，让开发者能将更多精力聚焦于编码本身。通过本指南，相信你已经掌握了nvm的核心用法。现在就开始在你的项目中实践起来，享受丝滑顺畅的版本管理体验吧！

滚动至顶部