返回博客

装 Node.js 总踩坑?官网 /nvm/fnm/Volta/ 包管理器,看完直接选对

装 Node.js 总踩坑?官网 /nvm/fnm/Volta/ 包管理器,看完直接选对

Node.js 安装指南:五种方式全面对比

装 Node.js 的方式比你想的多。官网安装包、nvm、fnm、Volta、包管理器……每种都有自己的适用场景。这篇文章把主流的几种方式走一遍,附上对比表,帮你选到适合自己的。

本文基于 2026 年 8 月的 Node.js 版本情况撰写。当前 Active LTS 为 v24(Krypton),Current 为 v26。


安装前:先搞清楚版本和工具链

选哪个版本?

Node.js 同时维护三个活跃版本:

版本 代号 状态 最新小版本 适合场景
v26 - Current v26.7.0 尝鲜新特性
v24 Krypton Active LTS v24.19.0 生产环境推荐
v22 Jod Maintenance LTS v22.23.2 老项目维护

不确定就选 v24 LTS。 生产环境只用 LTS 版本,这是社区共识。

Node.js 自带什么?

装完 Node.js 你会同时得到:

  • node:JavaScript 运行时
  • npm:包管理器(Node.js 自带)
  • npx:直接运行 npm 包中的命令

另外推荐了解一下 pnpmyarn,它们是 npm 的替代品,但不是必须的,初学用 npm 就够了。


方式一:官网安装包(最直接)

从 nodejs.org 下载对应平台的安装包,一路下一步。

Windows

  1. 打开 nodejs.org,点击「LTS」下载 .msi 安装包
  2. 双击运行,一路 Next
  3. 安装程序会自动把 node 和 npm 添加到 PATH
# 验证
node -v
# v24.19.0

npm -v
# 10.x.x

macOS

  1. 打开 nodejs.org,下载 macOS Installer (.pkg)
  2. 双击安装

也可以用 Homebrew:

brew install node@24

Linux

下载预编译二进制包,手动解压到 /usr/local

# 下载并解压
curl -fsSL https://nodejs.org/dist/v24.19.0/node-v24.19.0-linux-x64.tar.xz | tar -xJ -C /usr/local --strip-components=1

或者用包管理器(以 Ubuntu 为例):

# Ubuntu 需要先添加 NodeSource 源
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

优缺点

优点 缺点
最简单,适合新手 多版本切换几乎不可能
自动配置 PATH 升级需要重新下载安装
官方维护,最稳定 卸载不干净(Windows)

方式二:nvm / nvm-windows(最流行)

nvm 是最老牌的 Node.js 版本管理器。注意 nvm 和 nvm-windows 是两个不同的项目:nvm 面向 macOS/Linux(Bash 脚本),nvm-windows 面向 Windows(独立 Go 程序)。

安装 nvm(macOS / Linux)

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

安装完成后,重启终端或执行 source ~/.bashrc(zsh 用户执行 source ~/.zshrc)。

安装 nvm-windows(Windows)

  1. 前往 github.com/coreybutler/nvm-windows/releases
  2. 下载 nvm-setup.exe
  3. 安装前先卸载已有的 Node.js,否则会版本冲突
  4. 运行安装程序

基本用法

# 安装 LTS 版本
nvm install --lts

# 安装指定版本
nvm install 24
nvm install 22

# 切换版本
nvm use 24

# 查看已安装版本
nvm ls

# 设置默认版本
nvm alias default 24

# 使用 .nvmrc 自动切换(进入项目目录时)
echo "24" > .nvmrc
nvm use  # 自动读取 .nvmrc

优缺点

优点 缺点
社区最大,教程最多 nvm 本身是 Bash 脚本,启动慢
支持 .nvmrc nvm 和 nvm-windows 是两套代码
安装、切换、删除一条龙 Windows 上需先卸载已有 Node
跨版本测试方便 切换版本后全局包需要重装

方式三:fnm(最快)

fnm(Fast Node Manager)用 Rust 编写,启动速度比 nvm 快 10 倍以上,原生支持 .nvmrc,跨平台。

安装

macOS / Linux:

curl -fsSL https://fnm.vercel.app/install | bash

Windows:

winget install Schniz.fnm
# 或
choco install fnm

配置 Shell 自动切换(关键步骤,不配的话 fnm use 只在当前会话生效):

# bash
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc

# zsh
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc

# PowerShell (Windows)
fnm env --use-on-cd | Out-String | Invoke-Expression

基本用法

# 安装版本
fnm install 24
fnm install --lts

# 切换版本
fnm use 24

# 查看已安装
fnm list

# 设置默认
fnm default 24

# 进入含 .nvmrc 的目录时自动切换
# (需配置上面的 --use-on-cd)

优缺点

优点 缺点
Rust 编写,速度极快 社区比 nvm 小
原生跨平台(含 Windows) 需要手动配置 Shell 集成
自动切换版本(--use-on-cd) 命令和 nvm 略有不同
兼容 .nvmrc

方式四:Volta(团队协作利器)

Volta 的核心卖点是把 Node 版本锁定写进 package.json。团队成员 clone 项目后,Volta 自动切到正确版本,不用手动 nvm use

安装

macOS / Linux:

curl https://get.volta.sh | bash

Windows:

winget install Volta.Volta
# 或前往 https://volta.sh 下载 .msi

基本用法

# 安装 Node 版本
volta install node@24

# 在项目中锁定版本(写入 package.json)
cd my-project
volta pin node@24

# 安装全局工具(版本也会被锁定)
volta install ts-node

锁定后,package.json 会多出一段:

{
  "volta": {
    "node": "24.19.0"
  }
}

任何人进入这个目录,Volta 自动切换到 v24,不需要 .nvmrc,不需要手动操作。

优缺点

优点 缺点
项目级版本锁定,团队一致 功能相对单一
全局工具版本也锁定 不如 nvm/fnm 灵活
跨平台,Rust 编写 社区较小
零配置自动切换 切换不依赖 .nvmrc

方式五:系统包管理器(最省事)

如果你只需要一个 Node 版本,不想装额外工具,系统包管理器最快。

# macOS
brew install node@24

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# Windows
winget install OpenJS.NodeJS.LTS

# 或 Chocolatey
choco install nodejs-lts

优缺点

优点 缺点
一行命令搞定 版本通常不是最新
系统集成好 多版本管理不支持
升级方便 系统包可能和官方有差异

五种方式对比

维度 官网安装包 nvm/nvm-windows fnm Volta 包管理器
安装难度 最低 最低
多版本管理 不支持 支持 支持 支持 不支持
自动切换 不支持 需手动/脚本 支持 支持 不支持
速度 - 较慢(Bash) 极快(Rust) 快(Rust) -
跨平台 一般(两套代码) 各平台不同
项目级锁定 不支持 .nvmrc .nvmrc package.json 不支持
团队协作 一般 一般 最强
社区生态 官方 最大 增长快 中等 依赖系统
适合人群 新手 个人开发者 追求速度 团队 快速体验

怎么选

如果你是新手,只学一个项目:官网安装包。最简单,装完就能用。

如果你是个人开发者,需要多版本:fnm。比 nvm 快,跨平台,配置好 --use-on-cd 后自动切换版本,体验丝滑。

如果你一直用 nvm 且没觉得慢:继续用。nvm 社区最大,遇到问题最容易搜到答案。没必要为了快几秒迁移。

如果你是团队,想统一所有人的 Node 版本:Volta。把版本写进 package.json,git 提交后所有人自动锁定,彻底消灭「在我电脑上是好的」。

如果你只是想快速跑个脚本:系统包管理器一行命令搞定,不折腾。


npm 镜像加速(国内用户必看)

不管用哪种方式安装,装完后建议切换 npm 镜像源,否则下载包会很慢:

# 切换淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry
# https://registry.npmmirror.com

# 恢复官方源
npm config set registry https://registry.npmjs.org

总结

Node.js 安装这件事,官网安装包最省心,nvm 最经典,fnm 最快,Volta 最适合团队,包管理器最轻量。先想清楚你是个人用还是团队用、需不需要多版本,答案就出来了。

装完记得跑一下 node -vnpm -v,然后就可以开始写代码了。