跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

Windows 下使用 nvm 安装与管理 Node.js

在 Windows 系统下使用 nvm-windows 管理 Node.js 版本的完整流程。内容包括卸载旧版 Node.js、下载安装 nvm、验证安装、安装指定版本、切换版本以及常用命令速查。此外还涵盖了配置镜像源加速下载、设置默认版本、处理常见报错及高级技巧。通过 nvm 可实现多版本共存与灵活切换，提升开发效率。

邪神洛基发布于 2026/3/30更新于 2026/9/1063 浏览
Windows 下使用 nvm 安装与管理 Node.js

在开发过程中，你可能会遇到需要同时使用多个 Node.js 版本的情况：比如一个老项目依赖 Node 16，而新项目要求 Node 20。手动反复卸载重装不仅麻烦，还容易出错。

这时，nvm（Node Version Manager） 就派上用场了！它能让你在 Windows 上轻松安装、切换和管理多个 Node.js 版本。

📌 注意：Windows 上的 nvm 并非官方版本（官方 nvm 仅支持 macOS/Linux），而是由社区维护的 nvm-windows。

本文将手把手教你如何在 Windows 10/11 上安装 nvm，并用它来管理 Node.js。

一、准备工作

1. 卸载已有的 Node.js（重要！）

nvm 要求系统中不能预先安装 Node.js，否则会冲突。

卸载步骤：

  1. 打开'控制面板' → '程序和功能'
  2. 找到 Node.js，右键选择'卸载'
  3. 删除残留目录（如果存在）：
    • C:\Program Files\nodejs
    • C:\Users\<你的用户名>\AppData\Local\npm
  4. 清理环境变量：
    • 按 Win + R 输入 sysdm.cpl → '高级' → '环境变量'
    • 在'系统变量'和'用户变量'中，找到 Path
    • 删除所有包含 nodejs 或 npm 的路径条目

✅ 完成后重启命令提示符，输入 node -v 应提示'不是内部或外部命令'。

文章配图

二、下载并安装 nvm-windows

1. 访问官方 GitHub 仓库

打开浏览器，进入：
🔗 https://github.com/coreybutler/nvm-windows/releases

2. 下载安装包
  • 找到最新版本（如 nvm-setup.zip）
  • 点击下载 nvm-setup.exe（这是图形化安装程序，推荐新手使用）

⚠️ 不要下载 nvm-noinstall.zip，除非你熟悉手动配置。

文章配图

3. 安装 nvm
  • 出现安全警告时点'是'
  • 安装向导启动：
    • 点击 Next
    • 接受许可协议 → Next
    • 点击 Install → Finish

    • 设置 Node.js 的符号链接路径（建议设为：C:\Program Files\nodejs）

    文章配图

    💡 这个路径将作为 node 命令的入口，必须不含空格和中文

    设置 nvm 安装路径（建议默认：C:\Users\admin\AppData\Local\nvm）

    文章配图

    解压（如果下载的是 zip）或直接运行 nvm-setup.exe

    文章配图

    ✅ 安装完成后，nvm 会自动配置好环境变量。

    三、验证 nvm 是否安装成功

    1. 输入以下命令：

    以管理员身份打开 命令提示符（CMD） 或 PowerShell

    （部分操作需要管理员权限）

    nvm version

    文章配图

    如果显示版本号（如 1.1.12），说明 nvm 安装成功！

    🔍 如果提示 'nvm' 不是内部或外部命令，请检查：是否完全卸载了旧版 Node.js、是否重启了终端（或重启电脑）、环境变量是否包含 nvm 路径（通常安装程序会自动添加）

    四、使用 nvm 安装 Node.js

    1. 查看可安装的 Node.js 版本
    nvm list available

    这会列出所有官方支持的 LTS 和 Current 版本。

    文章配图

    2. 安装指定版本（推荐 LTS）

    例如安装最新的 LTS 版本（如 20.12.0）：

    nvm install 20.12.0

    显示如下如图则安装完成

    文章配图

    也可以只指定主版本号，nvm 会自动安装该系列的最新版：

    nvm install 18

    文章配图

    3. 查看已安装的版本
    nvm list

    输出示例：

    文章配图

    五、切换 Node.js 版本

    使用 nvm use 命令激活某个版本：

    nvm use 20.12.0

    成功后会提示：

    文章配图

    验证当前版本：

    node -v # 输出 v20.12.0
npm -v # 显示对应 npm 版本

    ✅ 切换后，node 和 npm 命令会自动指向所选版本。

    六、常用 nvm 命令速查

    1. 基础信息类命令
    命令作用示例
    nvm version 或 nvm -v查看 nvm 自身版本nvm version → 1.1.12
    nvm help显示所有可用命令帮助nvm help
    nvm root显示 nvm 的安装根目录（即 Node.js 版本存放路径）nvm root → C:\Users\Alice\AppData\Roaming\nvm
    2. 安装与卸载 Node.js
    安装命令
    命令说明示例
    nvm install <version>安装指定精确版本nvm install 20.12.0
    nvm install <major>安装该主版本的最新版（自动补全）nvm install 18 → 安装 18.x 最新版
    nvm install lts安装最新的 LTS（长期支持）版本nvm install lts
    nvm install latest安装最新的 Current（开发版）版本nvm install latest

    ✅ 安装时会自动下载并解压到 nvm root 目录下的对应版本文件夹。

    卸载命令
    命令说明示例
    nvm uninstall <version>卸载指定版本（不能卸载当前正在使用的版本）nvm uninstall 16.14.0
    nvm uninstall <major>卸载该主版本的所有子版本（不推荐）❌ 通常不支持，需指定完整版本号

    ⚠️ 注意：必须先 nvm use 切换到其他版本，才能卸载当前版本。

    3. 版本查看与切换
    命令说明示例
    nvm list 或 nvm ls列出本地已安装的所有 Node.js 版本显示：
    * 20.12.0 (当前)
    18.17.0
    nvm list available 或 nvm ls available列出所有官方可安装的版本（含 LTS/Current 标记）显示远程版本列表
    nvm use <version>临时切换到指定版本（仅当前终端会话有效）nvm use 18.17.0
    nvm use <major>切换到该主版本的已安装最新子版本nvm use 18
    nvm current显示当前正在使用的 Node.js 版本nvm current → v20.12.0

    ✅ 切换成功后，node -v 和 npm -v 会立即反映新版本。

    4. 设置默认版本（持久生效）
    命令说明示例
    nvm alias default <version>设置默认启动版本（新终端自动激活）nvm alias default 20.12.0
    nvm alias查看所有别名（包括 default）输出：
    default -> 20.12.0
    nvm unalias default删除默认别名（不推荐）—

    💡 设置默认版本后，每次打开新的 CMD/PowerShell，都会自动使用该版本，无需手动 nvm use。

    5. 配置镜像源（加速下载）

    nvm 默认从官方 nodejs.org 下载，国内用户可能很慢。可通过修改配置文件启用国内镜像。

    步骤：
    1. 找到 nvm 安装目录
    2. 编辑 settings.txt 文件（若不存在则新建）
    3. 添加以下两行：
    node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

    ✅ 保存后，后续 nvm install 将自动从淘宝 NPM 镜像（npmmirror.com）下载，速度大幅提升！

    6. 清理与维护
    命令说明
    手动删除旧版本进入 nvm root 目录，直接删除不需要的版本文件夹（如 v16.14.0）
    清理 npm 缓存（可选）npm cache clean --force（每个 Node 版本有独立缓存）
    重置 PATH（故障排查）如果 node 命令失效，检查 C:\Program Files\nodejs 是否在系统 PATH 中，并确保它是 nvm 创建的符号链接
    7. 高级技巧 & 实用组合
    1. 快速安装并使用 LTS 版本
    nvm install lts
nvm use lts
nvm alias default lts
    2. 同时安装多个常用版本
    nvm install 18
nvm install 20
nvm install 22
    3. 查看某个项目所需的 Node 版本（配合 .nvmrc）

    如果项目根目录有 .nvmrc 文件（内容如 18.17.0），可快速切换：

    nvm use

    ⚠️ 注意：nvm-windows 不原生支持 .nvmrc 自动读取，但你可以手动执行：

    nvm use $(Get-Content .nvmrc)
    4. 检查是否为 64 位版本

    nvm-windows 默认安装 64 位。可通过以下命令确认：

    node -p "process.arch"

    输出应为 x64。

    七、常见问题解决

    ❌ 问题 1：nvm use 报错 'exit status 1: Access is denied.'

    原因：权限不足，无法创建符号链接。

    解决方法：

    • 以管理员身份运行 CMD 或 PowerShell
    • 或在安装 nvm 时，确保目标路径（如 C:\Program Files\nodejs）有写入权限
    ❌ 问题 2：切换版本后 npm 命令失效

    原因：npm 是随 Node.js 一起安装的，每个版本自带独立的 npm。

    解决方法：

    • 确保使用 nvm use 正确切换
    • 不要手动修改 PATH 中的 npm 路径
    ❌ 问题 3：下载速度慢或失败

    解决方法：配置国内镜像（需手动修改 nvm 设置文件）

    1. 打开 nvm 安装目录（C:\Users\admin\AppData\Local\nvm）
    2. 编辑 settings.txt，添加：
    node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/

    八、总结

    通过 nvm-windows，你可以在 Windows 上：

    • 轻松安装多个 Node.js 版本
    • 一键切换项目所需的运行环境
    • 避免版本冲突和重复安装的烦恼

    这对于前端开发者、全栈工程师或参与多个项目的团队成员来说，是必备的开发利器。

    🎯 最佳实践建议：日常开发使用 LTS 版本（如 18、20、22），用 nvm alias default 设置主力版本，定期清理不用的旧版本：nvm uninstall 16.14.0

    参考资料：

    • nvm-windows 官方 GitHub：https://github.com/coreybutler/nvm-windows
    • Node.js 官网：https://nodejs.org
    • 国内镜像站（npmmirror）：https://npmmirror.com

    目录

    1. 一、准备工作
    2. 1. 卸载已有的 Node.js（重要！）
    3. 二、下载并安装 nvm-windows
    4. 1. 访问官方 GitHub 仓库
    5. 2. 下载安装包
    6. 3. 安装 nvm
    7. 三、验证 nvm 是否安装成功
    8. 四、使用 nvm 安装 Node.js
    9. 1. 查看可安装的 Node.js 版本
    10. 2. 安装指定版本（推荐 LTS）
    11. 3. 查看已安装的版本
    12. 五、切换 Node.js 版本
    13. 六、常用 nvm 命令速查
    14. 1. 基础信息类命令
    15. 2. 安装与卸载 Node.js
    16. 安装命令
    17. 卸载命令
    18. 3. 版本查看与切换
    19. 4. 设置默认版本（持久生效）
    20. 5. 配置镜像源（加速下载）
    21. 步骤：
    22. 6. 清理与维护
    23. 7. 高级技巧 & 实用组合
    24. 1. 快速安装并使用 LTS 版本
    25. 2. 同时安装多个常用版本
    26. 3. 查看某个项目所需的 Node 版本（配合 .nvmrc）
    27. 4. 检查是否为 64 位版本
    28. 七、常见问题解决
    29. ❌ 问题 1：nvm use 报错 “exit status 1: Access is denied.”
    30. ❌ 问题 2：切换版本后 npm 命令失效
    31. ❌ 问题 3：下载速度慢或失败
    32. 八、总结

    更多推荐文章

    查看全部
    • JavaScript 正则表达式详解
    • Python+ROS2 通用智能系统工业级通信框架
    • 全球老龄化背景下的护理机器人技术发展与挑战
    • SpringBoot3+Vue3 大事件项目前端代码优化与功能增强
    • Mem0 开源本地 AI 智能体长期记忆系统原理与实战
    • 医疗大模型：数据与知识双轮驱动的医学推理与临床决策支持
    • OpenClaw 入门指南：AI Agent 开发实践
    • WebRTC 在 Android 中的应用实战
    • 谷歌 Bard 更新：支持内网搜索及日程安排
    • Python 绘图库 Turtle 基础教程：坐标、画笔与实例
    • DeepSeek-R1 大模型基于 MS-Swift 框架的部署与微调实践
    • 具身机器人的软件系统架构
    • 基于 SpringBoot 与 Vue 的流浪宠物管理系统设计与实现
    • VS Code Copilot 深度使用指南：从安装到高级配置
    • Linux 生产者 - 消费者模型与条件变量详解
    • 文件的时间属性与时间戳管理
    • 常见 AI 降重工具功能对比与选择指南
    • Spring Cloud Alibaba AI 初体验
    • 高鋒集團黃俊瑯：資本與生態如何賦能傳統企業 Web3 轉型
    • 从三年前端到 CS 硕士：我在韩国留学的得失复盘

    相关免费在线工具

    • Keycode 信息

      查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

    • Escape 与 Native 编解码

      JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

    • JavaScript / HTML 格式化

      使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online

    • JavaScript 压缩与混淆

      Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online