解决不同项目需要不同 Node.js 版本的问题

告别"这是在我电脑上能跑"的魔咒：Node.js 多版本管理终极指南

你是否遇到过这样的场景：接手一个老项目，运行时疯狂报错；切回自己的新项目，又提示语法不支持。 根源往往只有一个------Node.js 版本不匹配。

本文将彻底解决这个困扰无数开发者的问题，教你一套优雅的 Node.js 多版本管理方案，让你在不同项目间自由切换，再无环境烦恼。

一、症状：你的Node.js版本管理出问题了

典型"病状"自查：

启动项目时，控制台输出 SyntaxError: Unexpected token '??='（常见于 Node.js 版本过低，不识别新语法）
运行npm install后，依赖死活装不上，或者启动就报错
团队中有人跑得好好的，你拉下来却各种异常
你电脑里明明装了新版Node，老项目却要求你必须降级

如果你中了一条以上，恭喜你，需要开始管理 Node.js 版本了。

二、根本原因：Node.js 版本更新太快，生态碎片化

Node.js 版本	发布时间	主要特性
v12	2019	相对稳定，但较老
v14	2020	LTS（长期支持版，很多老项目仍用）
v16	2021	支持 `??=`，`&&=` 等逻辑赋值运算符
v18	2022	支持原生 Fetch、Node.js 测试运行器
v20	2023	稳定版，性能提升
v22+	2024+	最新特性，需主动升级

核心矛盾 ：老项目不敢轻易升（怕 breaking changes），新项目又享受不到新特性。❌ 全局只有一个 Node 版本的模式，必然死路一条。

三、解决方案核心：nvm（Node Version Manager）

nvm 是什么？

一个让你在电脑上同时安装、共存多个 Node.js 版本 ，并能在终端里一键切换的工具。

🪟 Windows 用户指南：nvm-windows

1️⃣ 安装前的准备工作（非常重要！）

安装 nvm-windows 之前，务必彻底卸载电脑上原有的 Node.js，避免冲突：

"控制面板" -> "程序和功能" -> 卸载 Node.js

手动删除以下残留文件夹（如存在）：

text

makefile 复制代码

C:\Program Files\nodejs
C:\Program Files (x86)\nodejs
C:\Users<你的用户名>\AppData\Roaming\npm
C:\Users<你的用户名>\AppData\Roaming\npm-cache

检查系统的 PATH 环境变量，删除所有与 Node.js 或 npm 相关的路径

2️⃣ 安装 nvm-windows

访问 nvm-windows 发布页，下载最新版 nvm-setup.zip。
解压后，以管理员身份 运行 nvm-setup.exe。
按向导安装，路径建议保持默认（避免权限问题）。
安装完成后，重启命令行工具（CMD 或 PowerShell）。

3️⃣ 下载加速（国内用户强烈推荐）

在 nvm 安装目录（默认 C:\Users<你的用户名>\AppData\Roaming\nvm）下，找到 settings.txt，末尾添加：

text

ruby 复制代码

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

这样可以大幅提升国内下载 Node.js 的速度。

🍎 macOS / Linux 用户指南：标准版 nvm

在终端中执行：

bash

bash 复制代码

# 使用 curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# 或使用 wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

安装脚本会自动将 nvm 加入到你的 shell 配置文件（~/.bashrc、~/.zshrc 等）。安装完成后，重启终端 或运行 source ~/.zshrc（根据你的 shell 选择）使其生效。

四、一图看懂 nvm 核心操作

我要做什么	命令示例
查看能装哪些 Node 版本	Windows: `nvm list available` Mac/Linux: `nvm ls-remote`
安装某个具体版本	`nvm install 16.20.0`
安装最新的 LTS 版本	`nvm install --lts`
看我电脑里已有哪些版本	`nvm list`
在当前终端切换到某个版本	`nvm use 16.20.0`
设置默认（新打开终端）版本	`nvm alias default 16.20.0`
删除某个版本	`nvm uninstall 16.20.0`
查看当前使用版本	`node -v`

⚠️ Windows 用户特别注意 ：执行 nvm use 切换版本时，建议以管理员身份打开命令行，否则可能因权限不足而切换失败。

五、终极奥义：自动化项目版本切换（.nvmrc）

再也不用手动记住每个项目用的 Node 版本。

操作步骤

在项目根目录下，创建一个名叫 .nvmrc 的文件（注意开头有个点）。
文件内容只需一行，比如：16.20.0（或者 lts/gallium，等别名）。
当你要进入该项目工作时，在项目根目录执行：

bash
perl 复制代码
```
nvm use
```
nvm 会自动读取 .nvmrc 中指定的版本并切换过去。

更高级：自动切换（可选）

如果你希望每次 cd 进项目目录时自动切换 ，可以借助 avn 或 zsh-nvm 插件。但个人建议：手动执行 nvm use 已经足够简洁，且避免了误切换。