安装脚本会自动检测操作系统和 CPU 架构(x64 / ARM64、Intel / Apple Silicon),下载匹配的最新稳定版并完成初始化,无需手动选择安装包。
国内镜像(推荐,更快):
国际网络(GitHub):
等价写法:iwr -useb <上面的 URL> | iex
脚本行为:自动识别 x64 / ARM64 → 安装到 %USERPROFILE%\.pvm\bin\pvm.exe → 配置用户 PATH(默认不提权,不弹 UAC)。
国内镜像(推荐,更快):
国际网络(GitHub):
脚本行为:自动识别 Intel / Apple Silicon(Rosetta 终端也按原生 ARM64 处理)→ 安装到 ~/.pvm/bin/pvm → 写入 ~/.zshrc(bash 用户写 .bashrc,文件不存在会自动创建)。
macOS 上不要下载裸二进制后双击打开——它是命令行程序,双击会被文本编辑器当成文本报错。请始终使用上面的终端命令安装。
国内镜像(推荐,更快):
国际网络(GitHub):
脚本行为:自动识别 x64 / ARM64 → 安装到 ~/.pvm/bin/pvm → 写入 shell 配置文件(支持 bash / zsh / fish)。
curl 时自动改用 wget。source ~/.zshrc),运行 pvm version 验证。PVM 是单一二进制(不含额外的 shim 文件)。从 Release 页下载对应平台的文件:
下载的是命令行程序,不要双击打开(会被文本编辑器当成文本报错)。
请在终端中完成安装,见下方步骤。不确定架构时运行 uname -m:
x86_64 选 amd64,arm64/aarch64 选 arm64(Apple Silicon 的 Rosetta 终端也选 arm64)。
国内用户(Gitee 镜像):
| 平台 | 文件 | 直接下载 (latest) |
|---|---|---|
| Windows x64 | pvm-windows-amd64.exe | pvm-windows-amd64.exe |
| Windows ARM64 | pvm-windows-arm64.exe | pvm-windows-arm64.exe |
| macOS Intel | pvm-darwin-amd64 | pvm-darwin-amd64 |
| macOS Apple Silicon | pvm-darwin-arm64 | pvm-darwin-arm64 |
| Linux x64 | pvm-linux-amd64 | pvm-linux-amd64 |
| Linux ARM64 | pvm-linux-arm64 | pvm-linux-arm64 |
国际用户(GitHub):
| 平台 | 文件 | 直接下载 (latest) |
|---|---|---|
| Windows x64 | pvm-windows-amd64.exe | pvm-windows-amd64.exe |
| Windows ARM64 | pvm-windows-arm64.exe | pvm-windows-arm64.exe |
| macOS Intel | pvm-darwin-amd64 | pvm-darwin-amd64 |
| macOS Apple Silicon | pvm-darwin-arm64 | pvm-darwin-arm64 |
| Linux x64 | pvm-linux-amd64 | pvm-linux-amd64 |
| Linux ARM64 | pvm-linux-arm64 | pvm-linux-arm64 |
macOS / Linux 安装步骤(以 Apple Silicon 为例,其他架构替换文件名):
Windows 安装步骤(PowerShell):
也可下载 pvm-vX.X.X-{os}-{arch}.zip 解压后使用;macOS/Linux 解压后同样需要执行上面的 chmod +x 步骤。
安装脚本支持以下参数和环境变量:
| 选项 | 环境变量 | 说明 |
|---|---|---|
--version vX.Y.Z / -Version vX.Y.Z | PVM_INSTALL_VERSION | 安装指定版本(默认最新) |
--source auto|gitee|github / -Source ... | PVM_INSTALL_SOURCE | 指定下载源(默认 auto:Gitee 优先,失败回退 GitHub) |
-Scope user|admin(Windows) | PVM_INSTALL_SCOPE | user(默认)不弹 UAC,仅用户级 PATH;admin 自动提权重跑,额外把 pvm shims 前置到系统 PATH,结束时自动归还文件所有权 |
| — | PVM_HOME | 自定义安装根目录(默认 ~/.pvm) |
| — | PVM_REQUIRE_CHECKSUM=1 | Release 缺少 checksums.txt 时安装失败(默认仅警告) |
| — | PVM_NO_MODIFY_PROFILE=1(Unix)/ PVM_NO_MODIFY_PATH=1(Windows) | 不修改 shell 配置 / 用户 PATH |
示例:
Windows 还提供 MSI 安装包(双击安装,自动配置 PATH 并运行 pvm setup):
国内用户(Gitee):
| 平台 | MSI 安装包 |
|---|---|
| Windows x64 | pvm-windows-amd64.msi |
| Windows ARM64 | pvm-windows-arm64.msi |
国际用户(GitHub):
| 平台 | MSI 安装包 |
|---|---|
| Windows x64 | pvm-windows-amd64.msi |
| Windows ARM64 | pvm-windows-arm64.msi |
Gitee(国内): 源码:gitee.com/lycorxy/pvm · Release:gitee.com/lycorxy/pvm/releases
GitHub(国际): 源码:github.com/Lycorxy/pvm · Release:github.com/Lycorxy/pvm/releases方式一:直接下载(推荐)
下载后解压到项目的 .codebuddy/skills/ 目录即可。
方式二:Clone 仓库
Skill 位于 .codebuddy/skills/pvm-env-manager 目录,支持 CodeBuddy Skill 的 IDE 会自动加载。
首次直接运行 pvm(不带任何参数)会自动触发初始化:
手动初始化:
setup 会完成:
~/.pvm(可用环境变量 PVM_HOME 覆盖)。versions/、installs/、shims/ 子目录。~/.pvm/shims 与 ~/.pvm/bin 加入用户 PATH。pvm setup 时可选择以管理员权限把 pvm shims 前置到系统 PATH(一键安装默认不提权,仅修改用户级 PATH)。~/.pvm 所有权归还给当前用户,保证之后普通权限的终端 / IDE 一切可用,不会出现"管理员装完、普通权限装包失败"的问题。
日常开发用默认方式即可,全程不需要管理员权限。需要 pvm 压过系统级安装的
node / nvm(对所有用户生效)时,用 pvm setup --scope admin(Windows);
一键安装脚本对应 -Scope admin。即使以管理员安装,文件所有权也会自动
归还给你的账户,普通权限终端不受影响。
如果曾经用管理员 / sudo 安装导致普通终端装包失败,运行 pvm repair-owner 一次即可修复,详见 故障排查。
若终端找不到 pvm 或 node 等命令,运行自检:
该命令会检查并修复 PATH 配置、提示与其它版本管理器的冲突。
修改 PATH 后请重启终端(或 IDE)让 PATH 生效。 如果系统 PATH 冲突修复需要管理员权限,setup 会提示 UAC 弹窗。