Vibe Coding 知识库

nvm 介绍和安装 ​

nvm 是 Node Version Manager，用来在同一台机器上安装、切换和管理多个 Node.js 版本。它适合同时维护旧项目、新项目、教程项目和生产项目的人。

为什么需要 nvm ​

没有 nvm 时，系统通常只有一个全局 Node.js。项目 A 需要 Node 18，项目 B 需要 Node 22，项目 C 需要最新 LTS 时，就容易互相影响。

nvm 解决的是版本隔离问题：

  • 每个项目可以使用自己的 Node.js 版本。
  • 升级 Node.js 不会立刻影响所有项目。
  • 可以通过 .nvmrc 记录项目推荐版本。

macOS / Linux / WSL 安装 ​

官方 nvm 项目适用于 POSIX shell，包括 macOS、Linux 和 Windows WSL。

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

安装后重新打开终端，或按你的 shell 加载配置：

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

验证：

bash
command -v nvm
nvm -v

安装 Node.js LTS：

bash
nvm install --lts
nvm use --lts
node -v
npm -v

Windows 安装 ​

Windows 原生环境通常使用 nvm-windows。它不是 nvm-sh 的同一个项目，但目标相同：管理多个 Node.js 版本。

建议做法：

  1. 如果已经安装过 Node.js 官方 MSI，先卸载旧 Node.js。
  2. 下载 nvm-windows 安装包。
  3. 安装后重新打开 PowerShell。
  4. 安装并使用一个 LTS 版本：
powershell
nvm list available
nvm install 22
nvm use 22
node -v
npm -v

如果团队已经统一 Node.js 版本，以团队版本为准。

项目内固定版本 ​

在项目根目录创建 .nvmrc：

text
22

使用时：

bash
nvm use
npm install

如果本机还没安装对应版本：

bash
nvm install
nvm use

常见命令 ​

bash
nvm ls
nvm install 22
nvm use 22
nvm alias default 22
node -v
npm -v

来源 ​