首次初始化 PVM 目录结构并把 shims 加入 PATH。
setup-path 会诊断 PATH 是否包含 ~/.pvm/shims、~/.pvm/bin,
并提示与其它版本管理器(如 nvm)的冲突。
| Scope | 行为 | 适用场景 |
|---|---|---|
user(默认) | 全程不弹 UAC,只写用户目录与用户 PATH | 日常开发(推荐) |
admin | 自动弹 UAC 以管理员重跑完整 setup:把 pvm shims/bin 前置到系统 PATH(对所有用户生效),并在结束时自动归还文件所有权 | 需要压过系统级 nvm/node 等安装 |
如果系统 PATH 中存在 nvm 的 node(如 D:\node、D:\nvm)或系统 nodejs(D:\nodejs),
这些路径会覆盖 pvm 的用户级 shim——因为 Windows PATH 合并顺序为"系统 PATH 在前 → 用户 PATH 在后"。
setup 检测到冲突后会请求管理员权限,把 pvm shims 前置到系统 PATH 最前:
这样 pvm 的 shim 优先于 nvm 的软链接,node 命令走 pvm 的版本。nvm 的路径保留在末尾(下次重开终端即删除即可)。
不想弹 UAC 时用 pvm setup --no-elevate:只修改用户级 PATH,系统 PATH 冲突仅打印报告。
一键安装脚本默认就以此方式调用(不提权,仅用户级 PATH)。
问题:曾以"管理员身份"运行安装器 / pvm setup / pvm install(Windows),
或用 sudo 运行(macOS / Linux)后,~/.pvm 下由提升进程创建的文件归
Administrators / root 所有。之后普通权限的 pnpm / node shim 无法写入这些文件,
表现为"普通终端装包永远失败,必须管理员打开才成功",且删除重装也无法解决
(普通权限删不掉污染文件,或重装时再次被提升进程污染)。
两层防护:
pvm setup 后,会自动把 ~/.pvm
所有权归还给当前用户(Windows icacls /setowner、Unix chown -R),
之后普通终端永远可写,不会复发。pvm repair-owner 一次修复:修复完成后,用普通权限终端重装包即可,无需再以管理员打开 IDE / 终端。
PVM 是单一二进制——不需要单独的 pvm-shim。reshim 把 ~/.pvm/bin/pvm 硬链接为各命令名(node、npm、git 等),
pvm 启动时按自身文件名自分发到对应版本。详见 Shim 机制。
检查 PVM 安装健康度。
检查项包括:
~/.pvm 与各子目录是否存在。
修改 PATH 后请重启终端 / IDE,否则 doctor 可能仍报 PATH 未生效。
← 上一篇:config 下一篇:validate / diagnostics →