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 包中的命令
另外推荐了解一下 pnpm 和 yarn,它们是 npm 的替代品,但不是必须的,初学用 npm 就够了。
方式一:官网安装包(最直接)
从 nodejs.org 下载对应平台的安装包,一路下一步。
Windows
- 打开 nodejs.org,点击「LTS」下载
.msi安装包 - 双击运行,一路 Next
- 安装程序会自动把 node 和 npm 添加到 PATH
# 验证
node -v
# v24.19.0
npm -v
# 10.x.x
macOS
- 打开 nodejs.org,下载 macOS Installer (.pkg)
- 双击安装
也可以用 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)
- 前往 github.com/coreybutler/nvm-windows/releases
- 下载
nvm-setup.exe - 安装前先卸载已有的 Node.js,否则会版本冲突
- 运行安装程序
基本用法
# 安装 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 -v 和 npm -v,然后就可以开始写代码了。
