
---
## 1. 为什么需要 NVM？
在 Web 开发中，不同时期的项目往往依赖不同版本的 Node.js。例如，老旧的 Vue 2 项目可能需要 Node 14，而新的 Next.js 项目可能要求 Node 18+。如果全局安装多个版本，极易导致**依赖冲突**或**环境混乱**。
**NVM (Node Version Manager)** 正是为此而生：
   ✅ *多版本共存**：同一台机器同时安装 v14, v16, v18, v20...
   ✅ *一键切换**：瞬间在不同版本间跳转，无需重新安装。
   ✅ *项目隔离**：通过 `.nvmrc` 实现项目级别的版本自动匹配。
![image](https://developer.qcloudimg.com/http-save/yehe-12318300/2c3f6cf249005b783c7a033527251270.png)
---
## 2. Windows 系统安装指南 (nvm-windows)
Windows 下使用的是社区维护的 `nvm-windows` 版本，它是一个独立的 `.exe` 安装程序。
### 2.1 准备工作：彻底卸载旧版 Node.js ⚠️
**彻底卸载旧版 Node.js⚠️**
**彻底卸载旧版 Node.js ⚠️**
**彻底卸载旧版 Node.js ⚠️**
**重要**：安装前必须清理旧环境，否则会导致路径冲突，NVM 无法正常工作。
1.  **卸载程序**：
    *   打开 `控制面板` -> `程序和功能` (或 `设置` -> `应用`)。
    *   找到 `Node.js`，右键点击 `卸载`。
2.  **清理残留文件**：
    *   手动删除以下目录（若存在）：
        *   `C:\Program Files\nodejs`
        *   `C:\Program Files (x86)\nodejs`
        *   `C:\Users\<你的用户名>\AppData\Roaming\npm`
        *   `C:\Users\<你的用户名>\AppData\Roaming\npm-cache`
    *   提示：`AppData` 是隐藏文件夹，需在资源管理器“查看”选项中勾选“隐藏的项目”。
3.  **清理环境变量**：
    *   右键 `此电脑` -> `属性` -> `高级系统设置` -> `环境变量`。
    *   在 `用户变量` 和 `系统变量` 的 `Path` 中，删除所有包含 `nodejs` 或 `npm` 的路径。
    *   若存在名为 `NODE_PATH` 的变量，也请一并删除。
4.  **验证卸载**：
    *   打开新的 CMD 窗口，输入 `node -v`。
    *   若提示“不是内部或外部命令”，说明清理成功。
### 2.2 下载与安装 NVM
1.  **下载**：访问 [nvm-windows GitHub Releases](https://github.com/coreybutler/nvm-windows/releases)。 
2.  **安装包（可下载以下文件）**:
- [nvm-noinstall.zip](http://nvm-noinstall.zip)：绿色免安装版，但使用时需要进行配置。
- [nvm-setup.zip](http://nvm-setup.zip)：安装版，推荐使用
- nvm-setup.exe ：无需解压，直接安装，墙裂推荐！！！
![image](https://developer.qcloudimg.com/http-save/yehe-12318300/7f301ea0233d74ca9ae6fff242e31464.png)
3.  **运行安装**：
    *   双击运行，进入安装向导。
    *   **关键配置 1：NVM 安装路径** (`NVM_HOME`)：
        *   建议设置为无空格、无中文的路径，如 `D:\nvm`。
        *   ❌ 避免使用 `C:\Program Files` 等带空格的目录。
![image](https://developer.qcloudimg.com/http-save/yehe-12318300/6e1e966e63995e9c992daa1b124c8ab5.png)
    *   **关键配置 2：Node 符号链接路径** (`NODE_PATH`)：
        *   同样建议无空格路径，如 `D:\nodejs`。
        *   安装程序会自动在此目录下创建各版本的软链接。
        *   切记，这个文件夹下面不要有任何文件。
![image](https://developer.qcloudimg.com/http-save/yehe-12318300/8f90181af6def869462e8893e1c49152.png)
    *   点击 `Install` 完成安装。
### 2.3 配置国内镜像 (加速下载) 🇨🇳
国内用户直接从官方源下载 Node 极慢，需配置国内镜像。
1.  进入 NVM 安装目录（如 `D:\Appliation\nvm`）。
2.  用记事本打开 `settings.txt` 文件。
3.  在末尾添加以下内容：
    ```ini
    node_mirror: https://npmmirror.com/mirrors/node/ 
    npm_mirror: https://npmmirror.com/mirrors/npm/ 
    ```
4.  保存并关闭。
### 2.4 验证安装
以**管理员身份**打开 CMD 或 PowerShell，输入：
```bash
nvm version
```
若显示版本号（如 `1.2.22`），则安装成功。
---
## 3. macOS / Linux 系统安装指南 (原生 nvm)
macOS 和 Linux 使用官方提供的 `nvm` 脚本安装，功能更强大且支持更多特性。
### 3.1 准备工作
如果之前通过包管理器（`apt`, `yum`, `brew`）安装过 Node，建议先卸载：
*   **Ubuntu/Debian**: `sudo apt remove nodejs npm`
*   **CentOS/RHEL**: `sudo yum remove nodejs npm`
*   **macOS (Homebrew)**: `brew uninstall node`
### 3.2 安装 NVM
1.  打开终端。
2.  执行官方安装脚本（推荐使用最新版）：
    ```bash
    # 官方源
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh  | bash
    ```
    *   **国内备选**：若网络不通，可使用 Gitee 镜像：
        ```bash
        curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh  | bash
        ```
3.  脚本会自动修改你的 shell 配置文件（`.bashrc`, `.zshrc` 等）。
### 3.3 加载环境变量
安装后需重新加载配置：
```bash
# 关闭当前终端并重新打开，或执行：
source ~/.bashrc      # Bash 用户
source ~/.zshrc       # Zsh 用户 (macOS 默认)
```
### 3.4 验证安装
```bash
nvm --version
```
显示版本号即表示成功。
---
## 4. 核心操作流程图
为了更直观地理解 NVM 的决策逻辑，我们来看两个关键场景的流程图。
### 场景一：环境初始化与版本选择决策
这张图展示了从安装到确定当前开发环境的完整逻辑。
![image.png](https://developer.qcloudimg.com/http-save/yehe-12318300/70f84c609c5e7690da56f35e839ce18a.png)
>图 1: NVM 环境初始化与版本切换决策流程图
### 场景二：项目级版本自动切换 (.nvmrc)
当进入特定项目目录时，NVM 如何自动匹配版本？
![image.png](https://developer.qcloudimg.com/http-save/yehe-12318300/a57a05d9a543504a8359f75cb639596b.png)
>图 2: 基于 .nvmrc 的项目级版本自动匹配机制

---
## 5. 常用命令速查表
| 类别 | 命令 | 说明 | Windows 特有注意 |
| :--- | :--- | :--- | :--- |
| **查看版本** | `nvm ls` | 列出已安装的版本，`*` 为当前激活 | 通用 |
| | `nvm current` | 显示当前使用的 Node 版本 | 通用 |
| **安装版本** | `nvm install <ver>` | 安装指定版本 (如 18.20.4) | 通用 |
| | `nvm install --lts` | 安装最新的 LTS 版本 | 通用 |
| | `nvm install latest` | 安装最新的稳定版 | 通用 |
| **远程列表** | `nvm ls-remote` | 查看所有可安装的远程版本 | **Linux/Mac** |
| | `nvm list available` | 同上 (Windows 命令) | **Windows** |
| **切换版本** | `nvm use <ver>` | 切换到指定版本 | 通用 |
| | `nvm use --lts` | 切换到最新 LTS | 通用 |
| **卸载版本** | `nvm uninstall <ver>` | 卸载指定版本 | 通用 |
| **别名管理** | `nvm alias default <ver>` | 设置默认版本 (新开终端生效) | 通用 |
| **临时运行** | `nvm run <ver> app.js` | 用指定版本运行脚本，不切换环境 | 通用 |
|  |`nvm exec <ver> cmd` | 用指定版本执行命令  | 通用 |

---
## 6. 进阶技巧：项目级版本管理 (.nvmrc)
对于团队协作，强制统一 Node 版本至关重要。
### 6.1 创建 .nvmrc
在项目根目录创建一个名为 `.nvmrc` 的文件，写入所需版本号：
```text
18.20.4
```
### 6.2 自动切换策略
1.  **手动触发**：
    进入项目目录后，运行 `nvm use`，NVM 会自动读取 `.nvmrc` 并切换。
2.  **VS Code 自动集成 (推荐)**：
    安装插件 **"Auto-nvm"** 或 **"Version Control"**，或者在 VS Code 的 `settings.json` 中添加：
    ```json
    "files.watcherExclude": {
        "**/.nvmrc": true
    }
    // 配合插件可实现进入文件夹自动切换
    ```
3.  **Shell 自动钩子 (高阶)**：
    可以在 `~/.bashrc` 中添加一段代码，实现每次 `cd` 进入有 `.nvmrc` 的目录时自动执行 `nvm use`。
---
## 7. 常见问题排查 (FAQ)
*   **Q: 安装后 `nvm` 命令找不到？**
    *   A: 检查环境变量是否生效。Windows 需重启 CMD；Mac/Linux 需 `source` 配置文件。
*   **Q: 安装速度极慢？**
    *   A: 务必配置国内镜像（见第 2.3 节和第 3.2 节）。
*   **Q: 切换版本后 `npm` 还是旧的？**
    *   A: 确保没有单独在全局安装 `npm`，NVM 管理的 Node 自带对应的 npm。
*   **Q: Windows 下 `nvm use` 报错？**
    *   A: 检查是否以管理员身份运行 CMD，或者检查 `settings.txt` 中的路径是否包含中文/空格。
    
---

Windows 下使用的是社区维护的 nvm-windows 版本，它是一个独立的 .exe 安装程序。

nvm 安装教程：Node.js 版本管理全攻略 (Win/Mac/Linux) + .nvmrc 实战

本文详细介绍如何在 Windows、macOS 和 Linux 环境下安装和使用 nvm 工具。通过图文结合，手把手教你实现 Node.js 多版本共存、一键切换及项目环境隔离，解决依赖冲突难题，适合前端开发者快速上手。

Windows系统安装nvm-windows指南：彻底卸载旧版Node.js，配置无空格安装路径，设置国内镜像加速下载。macOS/Linux使用官方nvm脚本安装，配置环境变量。提供核心操作流程图、常用命令速查表及项目级版本管理技巧，解决常见安装问题。

包管理器

Windows

Ubuntu

Debian

Linux

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

nvm 安装教程：Node.js 版本管理全攻略 (Win/Mac/Linux) + .nvmrc 实战-腾讯云开发者社区-腾讯云

nvm 安装教程：Node.js 版本管理全攻略 (Win/Mac/Linux) + .nvmrc 实战

nvm 安装教程：Node.js 版本管理全攻略 (Win/Mac/Linux) + .nvmrc 实战

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐