nvm：Node 版本与 shell 状态
理解 nvm：运行在 shell 中的 Node 版本管理器
理解按用户安装、按 shell 选择运行时的机制，分清 nvm-sh/nvm 与 Windows 上其他同名工具。
你将学会
- 先把管理器与运行时分开
- 平台名称也是选型条件
- 评价可复现的项目流程
开始前需要
- 了解 shell 命令和进程环境
- 区分运行时安装与版本选择
诊断项目请求与实际 Node 版本的差异，并制定明确的接入和验证边界。
先看结论
- 管理器版本和 Node 版本是不同标识。
- 选择影响当前 shell 及之后启动的进程。
- shell 版项目与原生 Windows 替代工具不是同一个产品。
先把管理器与运行时分开
nvm-sh/nvm 管理多个 Node.js 安装，并为一个 shell 选择其中之一。它主要由 shell 函数实现，不是常驻服务器，也不是 JavaScript 运行时。检查的仓库报告 nvm 0.40.7，这描述的是管理器；Node 24.14.0 则是另一个组件，有独立的发布生命周期，不能把两者的版本号混用。
安装按用户组织，选择按 shell 生效。因此两个终端可以解析到不同的 Node 二进制，而不必替换同一个全局可执行文件。改变当前 shell 不会让已经运行的应用进程自动换运行时。这种模型尤其适合同时维护 Node 要求不兼容的多个项目。
平台名称也是选型条件
README 描述了 Unix、macOS 和 WSL 中的 POSIX 风格 shell，并对 Git Bash、Cygwin 给出带条件的说明。文档提到的原生 Windows 替代工具是其他实现，不由 nvm-sh 维护。不能假定针对 PowerShell 或另一款 nvm 编写的教程，具有相同安装目录、命令和切换行为。
由于 nvm 是 shell 函数，文档使用 command -v nvm 验证安装；只用 which 查找可执行文件容易误判。当前 shell 必须加载选定目录中的 nvm.sh。文件已经在磁盘上，不代表没有加载它的非交互进程也拥有 nvm 命令，这一层往往决定排障方向。
评价可复现的项目流程
项目可以在 .nvmrc 记录版本请求，再明确执行安装或选择。这个文件表达意图，不会仅因存在就下载 Node，也不会自动切换所有未来终端。文档中的目录切换钩子属于额外 shell 集成，其中一些能安装缺失版本，因此需要先审查实际行为。
本系列依据固定源码，并在隔离 Bash 子进程中执行了 16 项 PATH 与 .nvmrc 辅助函数案例。没有安装 nvm 或 Node、修改启动配置、运行完整上游测试，也没有验证生产部署。对 MIT 许可项目的评价建立在这些明确边界上，而不是虚构速度或兼容性排名。
实施步骤
- 1
确认操作环境和实际 shell。
- 2
检查 shell 是否已加载 nvm。
- 3
分别记录项目运行时要求与管理器版本。
- 4
运行项目测试前核对实际二进制。
可复制示例
# 只读检查；假定 nvm 已加载
command -v nvm
nvm --version
nvm current
nvm which current
node --version常见问题
切换 nvm 会升级正在运行的服务器吗？
不会。已有进程保留启动时的可执行文件和环境，应先选择版本，再启动新进程。
它与原生 Windows 的 nvm 程序一样吗？
不一样。本系列针对 nvm-sh/nvm 的 shell 模型，其他 Windows 实现具有独立维护者与行为。
资料来源
- README.md来源核查 2026-09-08
- package.json来源核查 2026-09-08
- LICENSE.md来源核查 2026-09-08
- nvm.sh来源核查 2026-09-08