nvm：Node 版本与 shell 状态
阅读 nvm 源码：PATH 顺序与不负责版本可用性的解析器
用 16 项隔离案例复现固定版本的 PATH 替换规则和 .nvmrc 边界，不凭命令名称猜测行为。
你将学会
- PATH 替换有条件分支
- 解析 .nvmrc 不证明运行时可用
- 实验范围应小于产品范围
开始前需要
- 了解 shell 命令和进程环境
- 区分运行时安装与版本选择
诊断项目请求与实际 Node 版本的差异，并制定明确的接入和验证边界。
先看结论
- 路径切换可能保留前面的自定义项和旧重复项。
- 删除管理项与替换某一项是不同函数。
- .nvmrc 返回字符串不证明 Node 版本受支持或已安装。
PATH 替换有条件分支
nvm_change_path 在输入为空时返回新目录，没有识别到管理路径时前置新目录。若已识别的系统二进制目录位于旧 nvm 路径之前，也会前置并保留旧项。其他情况下，sed 原位替换匹配项并保留前面的自定义目录。这些分支实现顺序策略，不是通用去重。
实验观察到 /tools/bin 自定义前缀保留在替换项之前，先出现 /usr/bin 会触发前置并保留旧项，而重复现代管理路径只替换第一项。nvm_strip_path 职责不同：它用 awk 删除匹配管理项，并保留末尾冒号。不能据此把结论推广到所有可能路径写法。
解析 .nvmrc 不证明运行时可用
nvm_process_nvmrc_content 去掉注释、修剪空白，拒绝有效内容为空或出现多个独立行。检查的实现允许不同键值行与一个独立版本请求共存，拒绝 node 键和重复普通键，且仍要求独立行。README 将键值内容保留给未来，因此不应把它当作应用配置机制。
实验中的辅助函数接受了独立的 not-a-node-version 字符串。这意味着解析阶段返回文本，不代表 nvm 能安装或运行该版本。可用性与受支持选择器检查属于后续阶段。分清语法、解析到版本和安装，可以防止把表面上的解析成功误写成项目环境已准备完成。
实验范围应小于产品范围
测试先验证完整 nvm.sh 的 Git blob，再原样提取五个已检查函数，在新的 Bash 子进程中执行。只有错误输出换成无副作用适配器，因此未测试上游颜色格式。16 项案例通过，没有加载整个管理器、安装 Node、改变父进程 PATH 或编辑任何 shell 配置。
早期测试把多行内容作为 Windows 命令参数传递，输入结构未按预期保留；修正后改用标准输入传递该内容。这属于测试传输问题，不是上游解析器缺陷。应记录准确输入、输出和边界，让实验验证实现，而不是意外验证启动器的另一种行为。
实施步骤
- 1
提取辅助函数前验证固定源码哈希。
- 2
测试空路径、自定义前缀、系统前缀和重复项。
- 3
用标准输入测试合法、缺失和冲突的 .nvmrc 内容。
- 4
区分内容解析结果与运行时版本解析、安装。
可复制示例
{
"观察案例数": 16,
"自定义前缀": "保留",
"系统目录在旧项之前": "前置新项，保留旧项",
"重复现代路径": "只替换第一项",
"未知独立版本文本": "解析器返回文本",
"运行时可用性已验证": false,
"已加载完整管理器": false
}常见问题
接受未知文本能证明安装存在缺陷吗？
不能据此得出结论。解析器返回请求字符串，后续版本解析与安装检查承担其他职责。
运行了全部上游测试吗？
没有。只在 16 项有界案例中执行五个提取函数，并使用错误输出适配器，不是完整上游测试。
资料来源
- nvm.sh来源核查 2026-09-08
- test/fast/Unit tests/nvm_change_path来源核查 2026-09-08
- test/fast/Unit tests/nvm_strip_path来源核查 2026-09-08
- README.md来源核查 2026-09-08