Node.js 与 NVM 版本管理：从单版本到多版本共存

Mon, 15 Aug 2016 00:00:00 +0800

为什么写这篇：2016 年的前端项目还经常"卡在 Node 版本"——A 项目要 Node 6、B 项目要 Node 8、C 项目要 Node 10……NVM（Node Version Manager）让一台机器同时装多个 Node 版本、随时切换。本文用 macOS/Linux（nvm-sh）和 Windows（nvm-windows）两条线讲解，最后给一个企业内网"从 Git 拉代码 → 构建 → 打 Docker 镜像 → kubectl apply"的全套脚本。

适用读者：刚装 Node 的新人；要维护多个不同 Node 版本项目的工程师；企业内网打包流水线维护者。

前置知识：会用命令行；知道 npm install 是什么。

1. Node.js 的版本节奏

Node.js 采用 SemVer（语义化版本） + LTS（长期支持） 双重节奏：

版本类型	说明	例子
Current（奇数大版本）	6 个月活跃开发期，包含新特性	17、19、21、23
Active LTS（偶数大版本）	12 个月活跃支持期，bugfix + 安全更新	18 LTS、20 LTS、22 LTS
Maintenance LTS	18 个月维护期，仅修安全漏洞	16 → 2023-09 终止
End-of-Life	不再提供任何更新，生产环境必须避免	14、17、19

选型建议：生产项目永远用 Active LTS。本文写作时的 LTS 主流是 Node 20.x / 22.x。

Node 重大里程碑：

版本	年份	关键变化
0.10	2013	第一个被广泛使用的稳定版
4.x	2015-09	0.12 → 4.0 的大版本合并（io.js 回流）
6.x	2016-04	LTS 时代开启
8.x	2017-05	LTS + npm 5 + async_hooks
10.x	2018-04	HTTP/2、n-api 稳定
12.x	2019-04	V8 升级、ES Modules 试验
14.x	2020-04	首次原生支持 ES Modules、V8 8.1
16.x	2021-04	V8 9.0、fs/promises 稳定
18.x	2022-04	内置 fetch、test runner
20.x	2023-04	权限模型、Single Executable Applications
22.x	2024-04	内置 WebSocket、类型剥离

2. Linux/macOS：nvm-sh 安装与使用

2.1 完全卸载旧 Node

1
2
3
4
5
6
7


# Ubuntu / Debian
sudo apt remove --purge nodejs npm -y
sudo apt autoremove -y
sudo apt autoclean

# macOS（用 Homebrew 装的）
brew uninstall node

2.2 一行命令装 nvm

1

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

脚本会自动在 ~/.bashrc / ~/.zshrc / ~/.config/fish/config.fish 里追加：

1
2


export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

让配置生效：

1

source ~/.zshrc # 或 source ~/.bashrc

2.3 fish shell 用户

fish shell 用户可以装 nvm.fish 插件（基于 Fisher 插件管理器）：

1
2
3
4
5
6
7
8
9


# 装 Fisher
curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher

# 装 nvm.fish
fisher install jorgebucaran/nvm.fish

# 卸载
fisher list
fisher remove jorgebucaran/nvm.fish

2.4 装指定版本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


# 列出所有可装的版本
nvm ls-remote

# 装最新版 LTS
nvm install --lts

# 装指定版本
nvm install v22.21.1
nvm install 20
nvm install 18.18.2

# 列出已装的版本
nvm ls
# -> v18.18.2
# -> v20.12.0
# -> v22.21.1
# default -> lts/* (-> v22.21.1)

# 切换版本
nvm use 20.12.0
nvm use 18.18.2

# 查看当前版本
node -v
npm -v

2.5 用 .nvmrc 锁定项目版本

在项目根目录放一个 .nvmrc：

1

20.12.0

之后进项目就 nvm use，nvm 会自动读 .nvmrc 切到对应版本。

1
2


# 还可以自动 install
nvm install # 读 .nvmrc，没有就装 lts

2.6 镜像加速（推荐）

nvm-sh 装 Node 时默认从 nodejs.org 下载，国内很慢。可以设镜像：

1
2
3
4
5


# 临时（本次命令）
NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node nvm install 20

# 永久（写到 shell 配置）
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

3. Windows：nvm-windows 安装与配置

Windows 上没有 nvm-sh，但有社区维护的 coreybutler/nvm-windows。

3.1 下载与安装

从 GitHub releases 下载最新 nvm-setup.zip（或免安装版 nvm-noinstall.zip），注意：必须以管理员权限运行 install.cmd。

3.2 配置 settings.txt

%NVM_HOME%\settings.txt（默认在 C:\Users\<用户>\AppData\Roaming\nvm\）：

1
2
3
4
5
6


root: <DEV_DIR>nvm
path: <DEV_DIR>nodejs
arch: 64
proxy: none
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

3.3 环境变量

变量	值
`NVM_HOME`	`<DEV_DIR>nvm`
`NVM_SYMLINK`	`<DEV_DIR>nodejs`
`PATH`	追加 `%NVM_HOME%;%NVM_SYMLINK%;`

Why 单独设 SYMLINK：nvm-windows 用 junction 软链接把当前激活的 Node 目录指向 NVM_SYMLINK，命令行的 node / npm 走 PATH 就能找到。

3.4 日常使用

1
2
3
4
5
6


nvm version # 查看 nvm 版本
nvm list available # 列出可装的版本
nvm install 22.21.1 # 装 Node 22.21.1
nvm use 22.21.1 # 切换
nvm ls  # 已装列表
nvm upgrade # 自更新 nvm 自身

3.5 离线安装

公司内网完全没外网时，先在有外网的机器上下好 node-v22.21.1-win-x64.zip：

1
2
3
4
5


下到 <DEV_DIR>nvm\v22.21.1\
├── node.exe
├── npm.cmd
├── npx.cmd
└── node_modules\

文件夹名必须是 <version> 格式（v22.21.1）。然后 nvm use 22.21.1 即可。

4. 镜像加速：解决 npm 装包龟速

4.1 设置 npm 镜像

1
2
3
4
5
6
7
8


# 临时
npm install <pkg> --registry=https://registry.npmmirror.com

# 永久
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry

4.2 nrm：多镜像一键切换

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


npm install -g nrm

nrm ls
# npm ---------- https://registry.npmjs.org/
# yarn --------- https://registry.yarnpkg.com/
# tencent ------ https://mirrors.cloud.tencent.com/npm/
# cnpm --------- https://r.cnpmjs.org/
# taobao ------- https://registry.npmmirror.com/

nrm use taobao
nrm use cnpm

4.3 cnpm：完全镜像版 npm

1
2


npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install lodash # 走国内 CDN，比 npm 快 5-10 倍

4.4 常见代理配置

1
2
3
4
5
6
7


# 命令行
$ npm config set proxy http://127.0.0.1:1081
$ npm config set https-proxy http://127.0.0.1:1081

# 环境变量（推荐，重启 shell 失效）
export npm_config_proxy=http://127.0.0.1:1081
export npm_config_https_proxy=http://127.0.0.1:1081

小贴士：Windows 11 上 npm.cmd 调全局安装时，prefix -g 在新 Node 18+ 下有 bug。可以改：
1
sed -i "s|prefix -g|prefix --location=global|g" "$(which npm.cmd)"
或直接用 npm install -g xxx——18+ 已默认 --location=global，这条 hack 主要针对 16 及以下。

5. npm 全局路径规划

默认情况下，npm 把全局包装到 %APPDATA%\npm（Windows）或 /usr/local/lib/node_modules（macOS/Linux），污染系统盘且与 Node 版本绑定。

5.1 自定义全局路径

1
2
3
4
5
6


# 自定义 prefix
npm config set prefix "<NPM_GLOBAL_DIR>"

# 在 PATH 中加 %NPM_HOME%
set NPM_HOME=<NPM_GLOBAL_DIR>
set PATH=%NPM_HOME%;%PATH%

这样全局装的所有包都在 <NPM_GLOBAL_DIR>，重装 Node 不会丢全局包。

5.2 全局装包管理

1
2
3
4
5
6
7
8
9


# 查看已装的全局包
npm list -g --depth=0

# 卸载
npm uninstall -g <pkg>

# 手动清（极少见）
# Windows: 删除 C:\Users\<user>\AppData\Roaming\npm\node_modules
# Linux: 删除 /usr/local/lib/node_modules/<pkg>

6. VSCode 智能提示与配套工具

6.1 @types/node

在项目里装 @types/node 后，VSCode 能智能提示 Node 内置模块（fs、path、process）和环境变量：

1

npm install --save-dev @types/node

6.2 运行脚本

1
2
3


node serve.js
node --inspect serve.js # 开启调试端口 9229
node --inspect-brk serve.js # 第一行就断点

6.3 treer：项目结构可视化

1
2


npm install -g treer
treer -e tree.txt -i "/node_modules|.git|.idea/"

会输出：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


D:/workspace/github/my-app
├── dist
├── node_modules
├── public
├── src
│ ├── App.vue
│ ├── main.ts
│ └── router
│ └── index.ts
├── index.html
├── package.json
└── vite.config.ts

方便在博文/Issue/聊天里分享目录。

7. 物理机手动打包发布全流程

公司内网没有 CI/CD 时，“开发把代码推上 Git → 运维在跳板机上拉代码 → 构建 → 打镜像 → 更新 K8s” 是常见流程。下面是一个典型脚本（所有内部信息已脱敏）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51


# ============ 1. 在构建机（127）执行 ============
# 用户名/密码：内部账号
cd /home/tmp

# 拉代码
git clone http://<GIT_HOST>:<PORT>/<ORG>/safety_microservices_vue.git
cd safety_microservices_vue/
git checkout -b hnTest
git pull origin hnTest

# 清理上次构建
rm -rf dist/

# 切 Node 版本
nvm use 18.18.2

# 用国内镜像
npm config set registry https://registry.npmmirror.com/
yarn config set registry https://registry.npmmirror.com/

# 清缓存重装
yarn cache clean --force
rm -rf node_modules
yarn
yarn build

# ============ 2. 同步到目标机（253）===========
cd /root/frontend
rm -rf *

# 用 sshpass 免密同步
sshpass -p <REDACTED> \
rsync -e 'ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null' \
 -avz --progress \
 root@<BUILD_HOST>:/home/tmp/safety_microservices_vue/dist /root/frontend/

mv dist html

# ============ 3. 打 Docker 镜像 ============
cat << "EOF" > Dockerfile
FROM <PRIVATE_REGISTRY>/base/bitnami/nginx:1.27.0-debian-12-r3
COPY html /app
EOF

docker build -t <PRIVATE_REGISTRY>/library/safety-frontend/pre:2025-08-18_001 .
docker push <PRIVATE_REGISTRY>/library/safety-frontend/pre:2025-08-18_001

# ============ 4. 改 K8s yaml 并应用 ============
sed -i "s|image:.*|image: <PRIVATE_REGISTRY>/library/safety-frontend/pre:2025-08-18_001|" \
 /data/k8scnf/safety-hnpre/11frontend.yaml
kubectl apply -f /data/k8scnf/safety-hnpre/11frontend.yaml

这种"半自动"流程的痛点：

任何一步失败要人工介入

镜像 tag 写死在 yaml 里，回滚要 git history

没有镜像扫描、签名、版本元数据

改进方向：把这条脚本拆成 GitLab CI / Jenkins Pipeline 的 stage，加 docker scan（trivy）、Helm Chart 管理版本。

小结

Node 装包是前端所有事的"前置依赖"。本文核心要点：

生产用 LTS（写作时是 Node 20/22），绝不用奇数版
多版本用 NVM（Linux/macOS）或 nvm-windows（Windows），.nvmrc 锁版本
国内必设镜像：registry.npmmirror.com 或 cnpm
npm 全局路径自定义，避免污染 C 盘或系统目录
物理机打包流程是"从 Git 到 K8s"的手动版，能跑但迟早要 CI/CD 化

参考资料

2024+ 视角：Node 22 LTS、pnpm 主导、Bun/Deno 三足鼎立

Node 22 LTS（2024-10 GA）核心变化

内置 WebSocket 客户端：globalThis.WebSocket 浏览器 API 移植，Node 服务端直接用
内置 node:test runner：不再依赖 Jest / Mocha 也能跑单测
权限模型（稳定）：--permission --allow-fs-read=./src 限制 Node 进程的 FS/网络/子进程权限
类型剥离（Type Stripping）：node --experimental-strip-types app.ts 直接跑 TS 文件
V8 12.4 升级：原生支持 Array.fromAsync / Error.cause 改进

1
2
3
4
5


# Node 22 一行跑 TS
node --experimental-strip-types app.ts

# 限制权限运行
node --permission --allow-fs-read=. --allow-fs-write=./dist app.js

Node 22 → Node 23 → Node 24 路线图

Node 23（2024-10 Current）：WebSocket 稳定、node:fs 性能优化
Node 24（2025-04 LTS）：内置 require(esm) 默认开启、V8 12.6、npm 11
Node 25（2025-10 Current）：实验性 HTTP/3、QUIC

pnpm 9.x 主导企业市场

pnpm 已成 2024+ 企业前端标配——比 npm 快 2-3 倍、磁盘占用节省 70%：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 装 pnpm
npm install -g pnpm@9

# 装依赖（比 npm 快 2-3 倍）
pnpm install

# monorepo 经典用法
pnpm -r add lodash
pnpm --filter my-app build
pnpm --filter my-app test

pnpm 核心优势：

硬链接 + 符号链接：项目间共享 node_modules 里的文件，磁盘省 70%
monorepo 原生支持：pnpm-workspace.yaml
依赖隔离更严：默认阻止"幽灵依赖"——只用 package.json 里声明的包
比 yarn 快、比 lerna 简单

Bun 1.x 2024+ 现状

Bun 是 Zig 写的 JavaScript 运行时——主打"Node 替代"：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 装 Bun
curl -fsSL https://bun.sh/install | bash

# 直接跑 TS
bun run app.ts

# 装依赖（比 npm 快 25 倍）
bun install

# 内置 SQLite / HTTP server / 打包器
bun --hot app.ts

维度	Node 22 LTS	Bun 1.x	Deno 2
启动速度	慢	3x 快	2x 快
装包速度	npm 11 一般	25x 快	1x
TS 支持	实验性 `--strip-types`	原生	原生
API 兼容	-	95% Node 兼容	Deno 原生
生产稳定	✅	较新	✅
生态	最大	增长中	中等

选型：

传统企业（稳）：Node 22 LTS + pnpm 9
新项目（性能优先）：Bun 1.x —— 启动快 3 倍、装包快 25 倍
Deno 强项：边缘计算（Deno Deploy）+ 安全沙箱

Node 测试生态 2024+

1
2
3
4
5
6
7
8


# Node 22 内置 test runner
node --test

# 第三方主流
vitest # 2024+ 最快（基于 esbuild）
node:test # 内置
jest # 老牌
playwright # E2E

1
2
3
4
5
6
7


// Node 22 内置 test runner 示例
import { test } from 'node:test';
import assert from 'node:assert/strict';

test('adds 1 + 2', () => {
 assert.equal(1 + 2, 3);
});

NVM 2024+ 替代品

fnm（Fast Node Manager）：Rust 写的，比 nvm 快 10 倍
volta：JavaScript 写的，团队级版本锁定
nvm-windows 仍是 Windows 唯一主流

1
2
3
4


# fnm（2024+ 推荐）
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22
fnm use 22

npm 11.x 关键变化

Workspaces 增强：npm install -w @myorg/pkg 直接给子包装
内置 SBOM 生成：npm sbom 输出 CycloneDX / SPDX 格式
npm exec 替代 npx 语义更清晰
Lockfile v3：package-lock.json 格式变化，更安全

Vite 6 + esbuild 2024+

1
2
3
4


# Vite 6（2024-11 GA）
npm create vite@latest my-app -- --template vue-ts
cd my-app
pnpm dev

Vite 6 引入 Environment API（SSR / SPA 统一 API）
Rolldown（Rust 写的 Rollup 替代）2024 进入 alpha——比 Rollup 快 10 倍
esbuild 0.24+ 完全稳定，TypeScript / JSX 编译首选

前端框架 2024+ 状态

框架	2024+ 状态
React 19	编译器优化、Server Components GA
Vue 3.5	响应式系统重写、性能 +50%
Svelte 5	Runes 语法（编译时反应性）+ 体积 -30%
Solid.js 1.9	2024 性能 SOTA
Astro 5	内容驱动 + Island 架构
Next.js 15	React 19 + Turbopack GA
Nuxt 3.14	Vue 3.5 + Nitro 2.10

2024+ 推荐组合

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


企业前端项目（稳）
├── Node 22 LTS（2024-10 GA）
├── pnpm 9.x（依赖管理）
├── Vite 6（构建）
├── TypeScript 5.6+（类型）
├── Vitest（测试）
├── ESLint 9 + Prettier 3（代码风格）
└── Playwright（E2E）

新项目（性能优先）
├── Bun 1.x（运行时）
├── Vite 6 + Rolldown alpha
├── TypeScript 5.6+
└── Solid.js / Svelte 5（轻量框架）

版本管理 on Liangweidong's blog