搞懂 nvm-windows 的 Node 版本切换：安装程序、符号链接与发布流程一次讲透

【免费下载链接】nvmThe Node.js version manager for Windows.项目地址: https://gitcode.com/gh_mirrors/nv/nvm

你刚接手一个老项目，node -v 显示 14，而项目要求 18，手动再下个 Node 塞进 C:\Program Files 只会更乱。nvm-windows 在 Windows 上安装多个 Node 版本，把 Node 版本切换变成一条命令：nvm use 即切即用。

它到底在解决什么问题

很多常见的 Node 版本管理器只在 Mac/Linux 上运行，Windows 上的一些工具靠 .bat 环境变量技巧实现，或者依赖一台已经装好的 Node。nvm-windows 用 Go 语言写成，不依赖任何已安装的 Node，支持 Node 4 以上版本。

如果你正在找一个 Node 版本切换工具 Windows 上能用的，nvm-windows 是少数不依赖 Node 本身的实现：多个版本装在一个目录里，nvm use 18 立刻生效，所有已打开的终端同步切换，不用每次新开窗口都重跑一遍。

核心模块怎么分工的

项目主体是一个 Go 程序，最核心的就 5 个模块：

• src/nvm.go：主程序入口，处理 install、use、list 等全部命令
• src/node/node.go：管理已安装的各个 Node 版本
• src/semver/semver.go：版本号解析与比较
• src/web/web.go：下载 Node 和 npm，支持换镜像源和代理
• src/upgrade/check.go：检查 Node/nvm 新版本并弹出通知

关键机制拆解

nvm-windows 的 Node 版本切换是怎么做的

秘诀是一条符号链接（symlink）：

• 输入：你在管理员终端里敲 nvm use 18.0.0
• 安装时，安装脚本 nvm.iss 只往系统 PATH 里放一个符号链接目录（NVM_SYMLINK）
• nvm use 并不改 PATH，只是把符号链接的指向换成对应版本的安装目录
• 输出：所有已打开的终端立刻能用到新版本，重启电脑后依然生效
• Windows 创建符号链接需要管理员权限，所以会触发 UAC 提权

nvm 是怎么知道有哪些版本可装的

• 安装时从 Node 官方站点拉取版本清单，不再靠抓取页面
• web 模块负责全部网络请求，配合 nvm node_mirror 换源、nvm proxy 设代理
• src/upgrade/check.go 把本地已装列表和近 1 个月的新版本做对比，开了订阅就会弹通知

安装程序是怎么打出来、怎么发布的

• build.js 读取 src/manifest.json 里的版本号，替换 nvm.iss 中的 {{VERSION}}，再调用 assets/buildtools 里的 Inno Setup 编译器打出安装程序
• CI 分两步：推送 main 分支后，autotag 工作流自动按 manifest 里的版本号打标签，release 工作流在 windows-latest 上编译并生成发布
• 整个 nvm 安装流程由这个安装程序一次完成，环境变量、卸载项都替你配好

版本策略与质量关口

• 版本号遵循 SemVer：大版本给不兼容改动，次版本给新功能，修订号给 bug 修复；仓库当前版本为 1.2.1
• 1.1.8 起内置升级工具：nvm 升级流程就是再跑一遍新安装程序，它只覆盖 nvm 自己的文件，不碰你已装的 Node
• 1.1.9 起安装包经过代码签名（1.1.8 一次因证书过期未签名），减少杀毒软件误报
• 安装程序要求管理员权限（nvm.iss 里 PrivilegesRequired=admin），发布同样有 CI 把关：先打标签再构建

装完怎么确认 nvm-windows 的 Node 版本切换真的在工作

打开一个管理员终端，用 2 条命令验证：

1. nvm version —— 显示 nvm 自己的版本号（如 1.2.1），说明装好了
2. nvm install lts 后接 nvm use lts，再跑 node -v —— 显示刚装的 LTS 版本号，说明切换生效

如果 node -v 一直显示旧版本，跑 nvm debug 检查有没有 PATH 冲突。

容易踩的坑

• 没先卸载原有 Node 就安装 → 旧安装目录还留在 PATH 里，nvm use 看起来毫无反应
• 没用管理员权限运行 → 符号链接建不出来，nvm 命令静默失败
• 把符号链接指向 C:\Program Files\nodejs 这类已存在的目录 → 符号链接无法覆盖真实目录，配置直接失败
• 装完不重启终端 → 新环境变量不生效，nvm 提示"不是内部命令"
• 全局 npm 包不跨版本共享 → 切换后 yarn 这类工具要按版本重装

团队正在开发后继项目 Runtime (rt)，你可以去仓库提 issue 或留下反馈。装好后，用上面 2 条命令几秒钟就能确认一切正常。

【免费下载链接】nvmThe Node.js version manager for Windows.项目地址: https://gitcode.com/gh_mirrors/nv/nvm