更换 Node.js 版本**强烈不建议**去官网反复下载覆盖安装,这容易导致环境变量混乱。
最标准、最优雅的做法是使用 **Node 版本管理工具(NVM)**。它可以让你在一台电脑上安装多个 Node 版本,并随时一键切换。
由于 Windows 和 Mac/Linux 使用的 NVM 工具不同,请根据你的操作系统查看对应步骤:
🪟 Windows 系统:使用 `nvm-windows`
如果你之前是通过官网下载的 `.msi` 安装包安装的 Node.js,**请务必先去"控制面板" -> "卸载程序"中把原来的 Node.js 卸载干净**,否则会冲突。
1. 安装 nvm-windows
* 前往 GitHub 发布页下载最新版:nvm-windows releases(https://github.com/coreybutler/nvm-windows/releases)
* 下载 `nvm-setup.exe` 并一路"下一步"安装。
* 安装完成后,**重新打开** CMD 或 PowerShell。
2. 常用切换命令
在终端(CMD / PowerShell / VS Code 终端)中输入以下命令:
* **查看可安装的 Node 版本列表**:
```cmd
nvm list available
```
* **安装指定版本**(例如安装 Node 16 的最新版,适合老 Vue 项目):
```cmd
nvm install 16.20.2
```
*(或者安装最新长期支持版:`nvm install lts`)*
* **查看已安装的版本**:
```cmd
nvm list
```
* **切换版本(核心命令)**:
```cmd
nvm use 16.20.2
```
*注意:Windows 下切换版本可能需要**以管理员身份运行**终端。*
🍎 Mac / 🐧 Linux 系统:使用 `nvm`
Mac 和 Linux 使用的是原生的 bash/zsh 脚本版 `nvm`。
1. 安装 nvm
打开系统自带的"终端 (Terminal)",运行以下命令(二选一):
* **使用 curl 安装**:
```bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
* **使用 wget 安装**:
```bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
```
* **重要**:安装完成后,**关闭终端并重新打开**,或者运行 `source ~/.zshrc` (如果是 zsh) / `source ~/.bashrc` (如果是 bash) 让环境变量生效。
2. 常用切换命令
* **安装指定版本**(Mac 下可以直接写大版本号,它会自动找该大版本下的最新版):
```bash
nvm install 16
```
* **查看已安装的版本**:
```bash
nvm ls
```
* **切换版本(核心命令)**:
```bash
nvm use 16
```
* **设置默认版本**(每次打开终端默认使用的版本):
```bash
nvm alias default 16
```
⚠️ VS Code 用户特别注意(避坑指南)
因为你之前提到在 VS Code 中使用 `yarn serve` 报错,当你在外部(或 VS Code 内部)使用 `nvm use` 切换了 Node 版本后,**VS Code 的集成终端可能不会立刻刷新环境变量**。
**切换版本后的正确操作姿势:**
-
在终端运行 `nvm use <版本号>` 切换成功。
-
在 VS Code 终端面板,**点击垃圾桶图标,彻底关闭当前终端**。
-
按 `` Ctrl + ` `` (或点击新建终端)**重新打开一个新的终端**。
-
在新终端中输入 `node -v`,确认版本号已经改变。
-
删除旧的 `node_modules` 和 `yarn.lock`,重新 `yarn install`,然后再 `yarn serve`。
*(如果重新打开终端还是旧版本,请尝试完全退出 VS Code 并重新打开项目。)*
💡 验证是否切换成功
无论什么系统,切换后在终端输入:
```bash
node -v
```
如果输出的版本号是你刚才 `nvm use` 的版本,说明更换成功!现在你可以去重新安装依赖并启动你的项目了。