2026最新Node.js+NVM全平台安装教程(10分钟即可搞定)

前言

在前端、后端全栈开发中，Node.js 是必不可少的运行环境，而不同项目往往依赖不同的 Node.js 版本，手动安装卸载不仅麻烦还容易冲突。

NVM（Node Version Manager） 作为 Node.js 版本管理神器，完美解决多版本切换问题，支持一键安装、切换、卸载任意 Node.js 版本，是开发者的必备工具。

本文是 2026 年最新保姆级教程，覆盖 Windows 10/11、macOS、Linux 全平台，从前置卸载旧版本 → NVM 安装 → Node.js 安装 → 环境优化 → 功能测试全程无坑，新手跟着操作 10 分钟即可搞定！

前置操作：彻底卸载旧版 Node.js（必做！）

如果你的电脑之前手动安装过 Node.js，必须先彻底卸载干净，否则会和 NVM 产生冲突，导致各种奇怪的问题！

Windows 系统卸载步骤

1. 打开 控制面板 → 程序和功能，找到 Node.js，右键选择「卸载」，按照向导完成卸载；

2. 删除残留目录（如果存在）：

   • C:\Program Files\nodejs

   • C:\Users[你的用户名]\AppData\Roaming\npm

   • C:\Users[你的用户名]\AppData\Roaming\npm-cache

3. 清理环境变量：

   • 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量

   • 在用户变量和系统变量的 Path 中，删除所有包含 node、npm 的路径

4. 验证清理：打开新的 CMD/PowerShell，输入 node -v，如果提示「不是内部或外部命令」，说明卸载干净了！

Mac/Linux 系统卸载步骤

1. 如果之前用 brew 安装的：

   brew uninstall node
   

2. 如果之前用官网安装包安装的，手动删除残留：

   sudo rm -rf /usr/local/{bin/node,lib/node_modules,include/node}
   sudo rm -rf ~/.npm ~/.node-gyp
   

3. 清理 shell 配置文件（~/.bashrc、~/.zshrc）中旧的 Node 相关环境变量；

4. 验证清理：打开终端，输入 node -v，提示命令不存在即清理成功。

一、NVM 版本管理器安装全流程

⚠️ 注意：Windows 系统和 Mac/Linux 系统的 NVM 是两个不同的项目，安装方式完全不同，不要搞混！

1.1 Windows 平台安装 NVM

Windows 没有原生的 NVM，我们使用社区维护的 nvm-windows，一键安装自动配置环境变量，新手友好！

步骤 1：下载最新版安装包

• 官方 GitHub 下载地址：https://github.com/coreybutler/nvm-windows/releases

• 找到最新版本（2026 年最新稳定版为 1.1.12），下载 nvm-setup.exe（推荐安装版，免手动配置，不要下载 zip 压缩包！）

步骤 2：一键安装

1. 双击运行 nvm-setup.exe，同意许可协议，点击「Next」；

2. 选择 NVM 安装路径：建议非中文、无空格路径，比如 D:\dev\nvm；

3. Node.js 快捷方式路径：默认即可，比如 C:\Program Files\nodejs；

4. 一路点击「Next」→「Install」，等待安装完成。

步骤 3：验证安装

打开 CMD 或 PowerShell（建议管理员身份），输入命令：

nvm version

如果输出版本号（如 1.1.12），说明 NVM 安装成功！

步骤 4：配置淘宝镜像（加速下载，必做！）

国内下载 Node.js 速度慢，我们配置 npmmirror 淘宝镜像，大幅提升下载速度：

1. 打开 NVM 的安装目录（比如 D:\dev\nvm），找到 settings.txt 文件；

2. 在文件末尾添加以下两行配置：

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

3. 保存文件即可，无需重启。

1.2 Mac/Linux 平台安装 NVM

Mac 和 Linux 系统使用官方的 nvm-sh，通过一键脚本即可完成安装。

步骤 1：执行安装脚本

打开终端，执行以下命令（2026 年最新稳定版为 v0.39.7）：

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

# 如果没有 curl，用 wget 也可以
# wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

步骤 2：配置环境变量

安装脚本会自动尝试将配置添加到你的 shell 配置文件中，但部分系统可能需要手动操作：

1. 打开你的 shell 配置文件：

   • 如果你使用的是默认的 bash：~/.bashrc 或 ~/.bash_profile

   • 如果你使用的是 zsh（Mac 新版默认）：~/.zshrc

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"
   

3. 让配置立即生效：

   # 如果是 bash
   source ~/.bashrc
   
   # 如果是 zsh
   source ~/.zshrc
   

步骤 3：验证安装

在终端输入命令：

nvm --version

输出版本号（如 0.39.7）即安装成功！

步骤 4：配置淘宝镜像（加速下载）

同样为了加速下载，我们配置环境变量，在你的 shell 配置文件中添加以下内容：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

添加后执行 source ~/.zshrc（或对应配置文件）让配置生效。

二、Node.js 安装与版本管理（全平台通用）

NVM 安装完成后，安装 Node.js 就非常简单了，所有平台的命令都是通用的！

2.1 查看可安装的 Node.js 版本

nvm list available

会列出所有可安装的版本，我们优先选择 LTS（长期支持版），稳定可靠，企业开发首选。

2.2 安装 LTS 长期支持版

2026 年推荐安装最新的 LTS 版本 v22.14.0（维护到 2027 年，稳定无坑），执行命令：

# 安装指定版本
nvm install 22.14.0

# 或者直接安装最新的 LTS 版本，自动识别
nvm install --lts

等待下载完成，会自动安装 Node.js 和对应的 npm 版本。

2.3 切换使用该版本

安装完成后，需要切换到刚安装的版本：

nvm use 22.14.0

如果输出 Now using node v22.14.0 (npm v10.8.1)，说明切换成功！

2.4 设置默认版本（必做！）

默认情况下，每次打开新的终端都需要重新 nvm use，我们可以设置默认版本，打开终端自动生效：

nvm alias default 22.14.0

设置完成后，以后打开终端直接就是这个版本，无需手动切换！

2.5 验证 Node.js 安装

输入以下命令，查看版本号：

# 查看 Node.js 版本
node -v

# 查看 npm 版本
npm -v

如果都能正常输出版本号，说明 Node.js 安装成功！

三、环境优化：配置 npm 淘宝源

装完 Node.js 后，npm 默认的源是国外的，下载包很慢，我们配置淘宝的 npmmirror 源，大幅提升下载速度：

npm config set registry https://registry.npmmirror.com

验证配置是否生效：

npm config get registry

输出 https://registry.npmmirror.com 就说明配置成功了！

可选：如果你想使用更快的包管理工具 pnpm，可以执行以下命令安装：

npm install -g pnpm

四、功能测试全流程

安装完成后，我们来完整测试一下 Node.js 和 npm 的功能是否正常。

4.1 基础运行测试

我们先测试最基础的 Node.js 代码运行：

1. 新建一个测试文件夹，比如 node-test，进入文件夹；

2. 新建 test.js 文件，写入以下代码：

   // 测试 Node.js 基础运行
   console.log("🎉 Hello Node.js！你的环境安装成功啦！");
   
   // 测试基础计算
   const a = 100, b = 200;
   console.log(`100 + 200 = ${a + b}`);
   
   // 测试 ES6+ 语法
   const arr = [1, 2, 3, 4];
   console.log("数组过滤结果：", arr.filter(item => item > 2));
   

3. 在文件夹下打开终端，执行命令：

   node test.js
   

4. 如果输出以下内容，说明基础环境完全正常：

   🎉 Hello Node.js！你的环境安装成功啦！
   100 + 200 = 300
   数组过滤结果： [ 3, 4 ]
   

4.2 内置 HTTP 服务测试

Node.js 自带了 HTTP 模块，我们来测试一下能不能启动一个 Web 服务：

1. 在同一个文件夹下新建 server.js，写入代码：

   const http = require('http');
   
   // 创建服务
   const server = http.createServer((req, res) => {
     res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
     res.end('✅ Node.js HTTP 服务启动成功！');
   });
   
   // 监听 3000 端口
   server.listen(3000, () => {
     console.log('服务已启动，访问：http://localhost:3000');
   });
   

2. 执行命令启动服务：

   node server.js
   

3. 打开浏览器，访问 http://localhost:3000，如果看到「Node.js HTTP 服务启动成功」，说明 Web 服务正常！

4. 按 Ctrl + C 停止服务。

4.3 npm 包管理测试

我们来测试一下 npm 能不能正常安装和使用第三方包：

1. 初始化项目：

   npm init -y
   

   会自动生成 package.json 配置文件。

2. 安装常用的网络请求包 axios：

   npm install axios
   

3. 新建 axios-test.js，写入测试代码：

   const axios = require('axios');
   
   // 测试请求 GitHub API
   axios.get('https://api.github.com')
     .then(res => {
       console.log("✅ 请求成功！状态码：", res.status);
       console.log("GitHub API 返回数据正常！");
     })
     .catch(err => {
       console.log("❌ 请求失败：", err.message);
     });
   

4. 执行测试：

   node axios-test.js
   

5. 如果输出以下内容，说明 npm 包管理完全正常：

   ✅ 请求成功！状态码： 200
   GitHub API 返回数据正常！
   

五、NVM 常用命令大全

整理了日常开发中最常用的 NVM 命令，收藏备用：

# 查看已安装的 Node 版本
nvm list

# 查看可安装的所有版本
nvm list available

# 安装指定版本
nvm install <version>

# 安装最新的 LTS 版本
nvm install --lts

# 切换到指定版本
nvm use <version>

# 设置默认版本
nvm alias default <version>

# 卸载指定版本
nvm uninstall <version>

# 查看当前使用的版本
nvm current

六、常见问题与解决方案

1.nvm command not found命令找不到

• 原因：Mac/Linux 下环境变量没配置好，或者没 source 配置文件；

• 解决：重新执行 source ~/.zshrc（或对应 shell 配置文件），检查配置文件里的 NVM 配置是否正确。

2. Windows 下nvm use报错，切换版本失败

• 原因：权限不足，或者之前的旧 Node 没卸载干净；

• 解决：以管理员身份运行 CMD/PowerShell，重新执行 nvm use，如果还是不行，检查旧版本是否卸载干净。

3. 下载 Node.js 速度很慢

• 解决：按照本文的步骤配置 NVM 的淘宝镜像，配置完重新安装即可。

4. 切换 Node 版本后，全局安装的包不见了

• 原因：不同 Node 版本的全局包是独立的，这是 NVM 的设计，避免版本冲突；

• 解决：如果需要全局包，可以在切换版本后重新安装，或者使用 nvm install node --reinstall-packages-from=previous 迁移旧版本的全局包。

5.node / npm命令不是内部或外部命令

• 解决：重启终端，重新执行 nvm use 切换版本，检查 NVM 是否安装成功。

总结

1. 优先使用 NVM 管理 Node.js 版本，避免多项目版本冲突，是开发者的最佳选择；

2. 安装 NVM 前一定要彻底卸载旧的 Node.js，否则会导致冲突；

3. 国内用户一定要配置淘宝镜像，大幅提升下载速度；

4. 安装完成后通过基础测试、HTTP 服务测试、npm 包测试，验证环境是否正常。

按照本教程操作，不管你是 Windows、Mac 还是 Linux，都能 10 分钟内搞定完整的 Node.js 开发环境，新手零失败！

到此这篇关于2026最新Node.js+NVM全平台安装教程的文章就介绍到这了,更多相关Node.js+NVM全平台安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！