企业官网建设流程全解析

nvm-windows 安装与发布全链路：4个环节讲透 Windows 上的 Node.js 多版本管理

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

Windows 上做多版本 Node.js 管理，nvm-windows 安装是最标准的第一步。这个用 Go 编写的 Node.js 多版本管理工具，被 Microsoft、npm 和 Google 官方推荐。本文讲清从源码到安装包的 4 个构建环节，以及装好之后必做的 3 件事。

nvm-windows 核心能力拆解：Node.js 多版本管理背后的三个设计点

市面上多数 Windows 版本管理器靠 .bat 脚本模拟环境变量、每次切换都重写 PATH。nvm-windows 换了一条路：它是一个不依赖任何已装 Node 的 Go 独立二进制，工具自身不会跟着 Node 的演进一起挂掉，机器上从没装过 Node 也能跑。主逻辑集中在 src/nvm.go，架构识别、下载、日志等按子模块拆分。

基于 symlink 的版本切换：为什么不用每次重设 PATH

安装时，nvm 把唯一的符号链接放进系统 PATH（例如C:\nvm\node）。之后nvm use只改这个链接指向哪个 Node 安装目录，PATH 本身纹丝不动。

两个直接收益：

• 切换一次，所有已打开的终端窗口立即生效，重启机器后依然保持，不用每开一个终端就nvm use一遍；
• 能提前避开最常见的"装完没反应"：C:\Program Files\nodejs这类真实目录无法被 symlink 覆盖，旧 Node 残留在 PATH 里时，nvm use看起来像什么都没发生。

语义化版本解析：latest 和 lts 是怎么被算出来的

nvm install latest装最新版、nvm install lts装最新稳定版、nvm use newest切到已安装的最新版本，这些模糊词全靠内置的 semver 模块解析。src/semver/里有一份完整的 SemVer 2.0.0 实现，三段号 Major.Minor.Patch 之外，预发布标签（如-beta.1）和构建元数据（如+build）也能正确参与比较。可下载版本清单则来自 Node 官方 index.json 接口，nvm list available的数据源就是它。

内置升级通道：1.1.8 之后的 nvm-windows 版本升级路径

从 1.1.8 版本起，nvm-windows 内置了升级工具：程序会拉取远端最新 release 信息并提示更新，升级逻辑在src/upgrade/模块中。关键是新安装程序只覆盖需要更新的文件，完全不碰你已安装的各个 Node 版本——升级 nvm-windows 和升级 Node.js 是两件互不干扰的事。

从源码到 Inno Setup 安装包：构建链路四步走

第一步，编译二进制。src/manifest.json 是构建描述文件：声明入口为nvm.go、产物输出到bin目录，并把 manifest 里的版本号在编译期注入二进制（即NvmVersion变量）。CI 环境用 Go 1.23 与 QuikGo 1.2.6 完成编译，release 档案还会开启代码压缩。

第二步，安装器脚本。根目录的 nvm.iss 是 Inno Setup 脚本：要求管理员权限安装、默认装到当前用户 AppData 下的 nvm 目录、LZMA 压缩、注册nvm://URL 协议，并在安装前执行迁移旧版 Node 文件的预处理逻辑。脚本中的{{VERSION}}占位符在打包前会被替换为真实版本号。

第三步，本地打包。build.js 是一个 Deno 小脚本，干两件事：从 manifest 读出版本号替换进 iss 文件，然后调用仓库自带的 Inno Setup 编译器（assets/buildtools/下的 iscc.exe）产出nvm-setup安装包，成品落在dist目录。

第四步，CI 发布流水线。.github/workflows/release.yml 由 autotag 工作流完成后触发：在 Windows runner 上提取该提交对应的版本标签、装配 Go 工具链、缓存依赖、编译、代码签名并发布产物；winget 工作流则把安装包同步进 WinGet 渠道。打 tag 之后，剩余环节无人工参与。

SemVer 三段号怎么定：版本策略与发布前的质量关卡

版本号遵循 SemVer 规则，仓库当前版本号为 1.2.1：

发布前的质量关卡：

• 多版本 Node.js 兼容性测试（官方支持 Node 4+）；
• Windows 不同版本（7/8/10/11）上的验证；
• 杀软兼容性：安装包做代码签名以降低误报（1.1.8 因证书过期是唯一未签名版本，1.1.9 起恢复签名）；
• 双架构覆盖：nvm install <version> all可同时装 32 位和 64 位版本，CI 按 64 位模式构建。

nvm-windows 安装：装好之后的三件小事

一、先卸载旧 Node，再装 nvm-windows。安装前彻底移除现有 Node.js 及其残留目录，并备份全局 npmrc（%AppData%\npm\etc\npmrc）。否则旧 Node 会在 PATH 中持续压过 nvm 的 symlink，表现为nvm use后node -v版本不变。拿不准就跑nvm debug（1.1.11+ 提供），它会直接检查 PATH 冲突。

二、用管理员终端，装完重启终端。管理 symlink 受 Windows UAC 限制，nvm-windows 必须在管理员身份的 PowerShell 或命令提示符里运行。安装完成后重启终端（不是重启电脑）即可加载新环境变量。

三、按需配置国内镜像源。nvm node_mirror与nvm npm_mirror分别把 Node 和 npm 的下载指向国内镜像，安装速度差异明显。root（Node 安装根目录）、path（symlink 路径）、arch、proxy 四项的完整写法可参考 examples/settings.txt。

另外注意：全局 npm 包（如 yarn）不跨 Node 版本共享，切换版本后需要重新npm install -g。

Runtime (rt)：团队正在研发的下一代工具

开发团队已全职转向 Runtime（rt），它是 nvm-windows 的继任者，目标是更强的能力与更好的体验；现有版本在此期间继续接收修复。

Node.js 多版本管理 Windows 场景下，nvm-windows 切换机制稳、升级平滑、发布链路全自动，可以放心使用。

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