logologo
首页
指南
命令参考
配置
常见问题
首页
指南
命令参考
配置
常见问题
logologo

入门

PVM 简介
安装与初始化
快速开始

核心概念

版本解析机制
Shim 机制
上一页快速开始
下一页Shim 机制

#版本解析机制

当你执行 node / python 等命令时,PVM 的 shim 会调用 ResolveVersion 决定实际运行的版本。 解析顺序从高到低为:

#解析优先级

优先级来源说明
1(最高)环境变量 PVM_<RT>_VERSION如 PVM_NODE_VERSION=20.11.0
2项目 .pvmrc / .nvmrc从当前目录向上查找
3用户全局 ~/.pvm/versionspvm use 写入的默认版本
4(最低)系统 PATH系统已装的同名命令,作为兜底

#环境变量覆盖

# 临时覆盖 node 版本,优先级高于 .pvmrc
export PVM_NODE_VERSION=18.19.0
node -v   # => v18.19.0

#项目文件查找

FindVersionFile 从当前工作目录向上逐层查找第一个 .pvmrc(也兼容 .nvmrc), 取其中该运行时的版本。例如:

# 项目根 / .pvmrc
node 20.11.0
python 3.12.0
注意

go / git 这类"全局唯一"运行时跳过项目级解析——即使历史 .pvmrc 里残留 go=xxx, 也不会被采用,避免误生效。

#特殊标记 system

.pvmrc 或 ~/.pvm/versions 中写入 system 表示"使用系统 PATH 中的全局安装版本",不下载:

node system

← 上一篇:快速开始 下一篇:Shim 机制 →