PROVIDER - Node.js 版本切换的事实标准

nvm

nvm 用 Shell 脚本管理 Node.js 版本,覆盖 10 年以上历史版本并支持 .nvmrc 约定,无需 root 权限、切换在 1 秒内完成;其边界是只管理 Node.js、非交互环境需额外配置且 Windows 需替代实现。

开发工具 美国 2026.11.19
4.2分

详细说明

优势 5 项

用 Shell 脚本实现 Node.js 版本安装与切换,覆盖 10 年以上历史版本
支持读取 .nvmrc 文件,进入项目目录后 1 条命令即可切换到约定版本
单机并存多个 Node 版本,切换在 1 秒内完成
无需 root 权限即可安装,全部版本存放在用户目录的 1 个路径下
生态最普及,Node 相关文档与教程中 90% 以上以 nvm 作为示例

不足 4 项

仅管理 Node.js,多语言场景需要额外工具
依赖 Shell 初始化脚本,非交互式环境与容器中需额外配置
官方不支持 Windows 原生环境,需使用 nvm-windows 等替代实现
切换依赖手动命令,无法像 Volta 那样自动生效

服务商概述

nvm(Node Version Manager)是最广泛使用的 Node.js 版本管理工具。它以 Shell 函数形式工作,把不同版本的 Node 安装到用户目录,并通过修改 PATH 决定当前生效的版本。

在开发工具分类里,它属于「单语言版本管理」的经典方案:虽然功能范围窄,但普及度极高,是绝大多数前端与 Node 后端项目的默认选择。

核心优势

  • 覆盖完整:可安装 10 年以上的历史版本
  • 约定友好:.nvmrc 让项目自带版本声明
  • 免 root:全部装在用户目录,无需系统权限
  • 切换快捷:1 秒内完成版本切换
  • 生态普及:文档与教程几乎默认以 nvm 为例

产品生态

平台能力

版本安装与卸载、默认版本设置、别名管理、.nvmrc 读取、镜像源配置与版本列表查询。

集成

可与 npm、yarn、pnpm、VS Code、GitHub Actions 以及各类前端脚手架配合。

典型场景

前端项目多版本共存、历史项目维护、CI 中固定 Node 版本。

不足之处

  • 仅限 Node.js:多语言项目需 asdf 或 mise
  • Shell 依赖:非交互环境与容器需额外初始化
  • Windows 缺口:需使用 nvm-windows 等第三方实现
  • 手动切换:不如 Volta 那样自动生效

适用场景

  • 前端与 Node 项目(★★★★★):最普及的选择
  • 维护历史版本项目(★★★★★):旧版本覆盖完整
  • 多语言仓库(★★★☆☆):应改用 asdf 或 mise
  • 容器内构建(★★★☆☆):直接用基础镜像固定版本更简单

价格参考

项目 价格 备注
nvm 本体 $0 MIT 开源,可商用
Node 版本下载 $0 官方镜像免费
商业支持 无 通过 GitHub Issue 获得帮助

常见问题

nvm 与 n 的区别是什么?

n 是 npm 全局包形式的版本管理工具,需要已有 Node;nvm 是独立的 Shell 函数,不依赖现有 Node。

为什么每次打开终端都要重新 nvm use?

因为 nvm 通过修改当前 Shell 的 PATH 生效,可用 .nvmrc 配合自动执行脚本简化。

支持 Windows 吗?

官方不支持原生 Windows,可使用 nvm-windows 或 WSL。

会影响全局 npm 包吗?

每个 Node 版本有独立的全局包目录,切换版本后需要重新安装。

代码示例

# 安装 nvm(macOS / Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 安装并使用指定版本
nvm install 20.11.1
nvm use 20.11.1
nvm alias default 20.11.1

# 在项目目录按 .nvmrc 切换
echo "20.11.1" > .nvmrc
nvm use

社区与资源

  • 源码仓库:https://github.com/nvm-sh/nvm
  • 安装说明:https://github.com/nvm-sh/nvm#installing-and-updating
  • Windows 版本:https://github.com/coreybutler/nvm-windows
前往 nvm 官网 → https://github.com/nvm-sh/nvm
访问官网 ↗