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

总览

命令总览

版本管理

install
use
list / list-remote
remove
current / which / where

项目与系统

config
setup / doctor
validate / diagnostics
self-update / uninstall
上一页config
下一页validate / diagnostics

#setup / doctor

#setup

首次初始化 PVM 目录结构并把 shims 加入 PATH。

pvm setup                     # 手动初始化(默认 user scope,无需管理员)
pvm setup --scope admin       # 管理员模式:UAC 提权重跑,额外前置系统 PATH
pvm setup --no-elevate        # 初始化但不请求管理员权限(仅报告系统 PATH 冲突)
pvm setup --fix-owner         # 仅修复 ~/.pvm 文件所有权
pvm repair-owner              # 检测并修复文件所有权(见下文)
pvm setup-path                # 仅检查并修复 PATH 配置

setup-path 会诊断 PATH 是否包含 ~/.pvm/shims、~/.pvm/bin, 并提示与其它版本管理器(如 nvm)的冲突。

#安装方式选择(--scope)

Scope行为适用场景
user(默认)全程不弹 UAC,只写用户目录与用户 PATH日常开发(推荐)
admin自动弹 UAC 以管理员重跑完整 setup:把 pvm shims/bin 前置到系统 PATH(对所有用户生效),并在结束时自动归还文件所有权需要压过系统级 nvm/node 等安装

#与 nvm / 系统 node 的冲突处理

如果系统 PATH 中存在 nvm 的 node(如 D:\node、D:\nvm)或系统 nodejs(D:\nodejs), 这些路径会覆盖 pvm 的用户级 shim——因为 Windows PATH 合并顺序为"系统 PATH 在前 → 用户 PATH 在后"。

setup 检测到冲突后会请求管理员权限,把 pvm shims 前置到系统 PATH 最前:

系统 PATH = [~/.pvm/shims, ~/.pvm/bin, ..., D:\node, D:\nvm, D:\nodejs]
              ↑ pvm 在最前,压过 nvm

这样 pvm 的 shim 优先于 nvm 的软链接,node 命令走 pvm 的版本。nvm 的路径保留在末尾(下次重开终端即删除即可)。

不想弹 UAC 时用 pvm setup --no-elevate:只修改用户级 PATH,系统 PATH 冲突仅打印报告。 一键安装脚本默认就以此方式调用(不提权,仅用户级 PATH)。

#文件所有权守护(repair-owner)

问题:曾以"管理员身份"运行安装器 / pvm setup / pvm install(Windows), 或用 sudo 运行(macOS / Linux)后,~/.pvm 下由提升进程创建的文件归 Administrators / root 所有。之后普通权限的 pnpm / node shim 无法写入这些文件, 表现为"普通终端装包永远失败,必须管理员打开才成功",且删除重装也无法解决 (普通权限删不掉污染文件,或重装时再次被提升进程污染)。

两层防护:

  1. 预防:新版以管理员(root)模式跑完 pvm setup 后,会自动把 ~/.pvm 所有权归还给当前用户(Windows icacls /setowner、Unix chown -R), 之后普通终端永远可写,不会复发。
  2. 自愈:存量污染用 pvm repair-owner 一次修复:
pvm repair-owner
# Windows:检测到污染 → 弹 UAC → icacls 归还所有权 → 自动复验
# macOS / Linux:检测到污染 → 提示 sudo pvm repair-owner → chown -R 归还

修复完成后,用普通权限终端重装包即可,无需再以管理员打开 IDE / 终端。

#单二进制

PVM 是单一二进制——不需要单独的 pvm-shim。reshim 把 ~/.pvm/bin/pvm 硬链接为各命令名(node、npm、git 等), pvm 启动时按自身文件名自分发到对应版本。详见 Shim 机制。

#doctor

检查 PVM 安装健康度。

pvm doctor

检查项包括:

  • 根目录 ~/.pvm 与各子目录是否存在。
  • shims 目录是否在 PATH 中(优先级是否够高)。
  • 已安装版本的完整性。
注意

修改 PATH 后请重启终端 / IDE,否则 doctor 可能仍报 PATH 未生效。


← 上一篇:config 下一篇:validate / diagnostics →