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

入门

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

核心概念

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

#安装与初始化

#一键安装

安装脚本会自动检测操作系统和 CPU 架构(x64 / ARM64、Intel / Apple Silicon),下载匹配的最新稳定版并完成初始化,无需手动选择安装包。

#Windows(PowerShell)

国内镜像(推荐,更快):

irm https://gitee.com/lycorxy/pvm/raw/master/scripts/install.ps1 | iex

国际网络(GitHub):

irm https://raw.githubusercontent.com/Lycorxy/pvm/master/scripts/install.ps1 | iex

等价写法:iwr -useb <上面的 URL> | iex

脚本行为:自动识别 x64 / ARM64 → 安装到 %USERPROFILE%\.pvm\bin\pvm.exe → 配置用户 PATH(默认不提权,不弹 UAC)。

#macOS(终端)

国内镜像(推荐,更快):

curl -fsSL https://gitee.com/lycorxy/pvm/raw/master/scripts/install.sh | bash

国际网络(GitHub):

curl -fsSL https://raw.githubusercontent.com/Lycorxy/pvm/master/scripts/install.sh | bash

脚本行为:自动识别 Intel / Apple Silicon(Rosetta 终端也按原生 ARM64 处理)→ 安装到 ~/.pvm/bin/pvm → 写入 ~/.zshrc(bash 用户写 .bashrc,文件不存在会自动创建)。

注意

macOS 上不要下载裸二进制后双击打开——它是命令行程序,双击会被文本编辑器当成文本报错。请始终使用上面的终端命令安装。

#Linux(终端)

国内镜像(推荐,更快):

curl -fsSL https://gitee.com/lycorxy/pvm/raw/master/scripts/install.sh | bash

国际网络(GitHub):

curl -fsSL https://raw.githubusercontent.com/Lycorxy/pvm/master/scripts/install.sh | bash

脚本行为:自动识别 x64 / ARM64 → 安装到 ~/.pvm/bin/pvm → 写入 shell 配置文件(支持 bash / zsh / fish)。

#安装脚本通用说明

  • Gitee 下载失败会自动回退 GitHub,无需手动切换。
  • 未安装 curl 时自动改用 wget。
  • 下载到临时文件,校验并验证可执行后才替换旧版本,不会破坏现有安装。
  • 指定版本 / 下载源等参数见下方高级选项。
  • 安装完成后重启终端(或 source ~/.zshrc),运行 pvm version 验证。

#手动下载

PVM 是单一二进制(不含额外的 shim 文件)。从 Release 页下载对应平台的文件:

macOS / Linux 用户注意

下载的是命令行程序,不要双击打开(会被文本编辑器当成文本报错)。 请在终端中完成安装,见下方步骤。不确定架构时运行 uname -m: x86_64 选 amd64,arm64/aarch64 选 arm64(Apple Silicon 的 Rosetta 终端也选 arm64)。

国内用户(Gitee 镜像):

平台文件直接下载 (latest)
Windows x64pvm-windows-amd64.exepvm-windows-amd64.exe
Windows ARM64pvm-windows-arm64.exepvm-windows-arm64.exe
macOS Intelpvm-darwin-amd64pvm-darwin-amd64
macOS Apple Siliconpvm-darwin-arm64pvm-darwin-arm64
Linux x64pvm-linux-amd64pvm-linux-amd64
Linux ARM64pvm-linux-arm64pvm-linux-arm64

国际用户(GitHub):

平台文件直接下载 (latest)
Windows x64pvm-windows-amd64.exepvm-windows-amd64.exe
Windows ARM64pvm-windows-arm64.exepvm-windows-arm64.exe
macOS Intelpvm-darwin-amd64pvm-darwin-amd64
macOS Apple Siliconpvm-darwin-arm64pvm-darwin-arm64
Linux x64pvm-linux-amd64pvm-linux-amd64
Linux ARM64pvm-linux-arm64pvm-linux-arm64

macOS / Linux 安装步骤(以 Apple Silicon 为例,其他架构替换文件名):

cd ~/Downloads
mkdir -p ~/.pvm/bin
mv pvm-darwin-arm64 ~/.pvm/bin/pvm
chmod +x ~/.pvm/bin/pvm
~/.pvm/bin/pvm setup

Windows 安装步骤(PowerShell):

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.pvm\bin"
Move-Item "$env:USERPROFILE\Downloads\pvm-windows-amd64.exe" "$env:USERPROFILE\.pvm\bin\pvm.exe"
& "$env:USERPROFILE\.pvm\bin\pvm.exe" setup

也可下载 pvm-vX.X.X-{os}-{arch}.zip 解压后使用;macOS/Linux 解压后同样需要执行上面的 chmod +x 步骤。

#高级选项

安装脚本支持以下参数和环境变量:

选项环境变量说明
--version vX.Y.Z / -Version vX.Y.ZPVM_INSTALL_VERSION安装指定版本(默认最新)
--source auto|gitee|github / -Source ...PVM_INSTALL_SOURCE指定下载源(默认 auto:Gitee 优先,失败回退 GitHub)
-Scope user|admin(Windows)PVM_INSTALL_SCOPEuser(默认)不弹 UAC,仅用户级 PATH;admin 自动提权重跑,额外把 pvm shims 前置到系统 PATH,结束时自动归还文件所有权
—PVM_HOME自定义安装根目录(默认 ~/.pvm)
—PVM_REQUIRE_CHECKSUM=1Release 缺少 checksums.txt 时安装失败(默认仅警告)
—PVM_NO_MODIFY_PROFILE=1(Unix)/ PVM_NO_MODIFY_PATH=1(Windows)不修改 shell 配置 / 用户 PATH

示例:

curl -fsSL https://gitee.com/lycorxy/pvm/raw/master/scripts/install.sh | bash -s -- --version v0.0.2 --source github

Windows 还提供 MSI 安装包(双击安装,自动配置 PATH 并运行 pvm setup):

国内用户(Gitee):

平台MSI 安装包
Windows x64pvm-windows-amd64.msi
Windows ARM64pvm-windows-arm64.msi

国际用户(GitHub):

平台MSI 安装包
Windows x64pvm-windows-amd64.msi
Windows ARM64pvm-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

#获取 Skill

方式一:直接下载(推荐)

  • 从 GitHub Release 下载
  • 从 Gitee Release 下载(国内更快)

下载后解压到项目的 .codebuddy/skills/ 目录即可。

方式二:Clone 仓库

# Clone PVM 仓库(包含 Skill)
git clone https://github.com/Lycorxy/pvm.git
# 或从 Gitee 克隆(国内更快)
git clone https://gitee.com/lycorxy/pvm.git

Skill 位于 .codebuddy/skills/pvm-env-manager 目录,支持 CodeBuddy Skill 的 IDE 会自动加载。

#首次初始化(setup)

首次直接运行 pvm(不带任何参数)会自动触发初始化:

pvm
# Welcome to pvm! It looks like this is your first run.
# Running setup to configure pvm...

手动初始化:

pvm setup

setup 会完成:

  • 创建根目录 ~/.pvm(可用环境变量 PVM_HOME 覆盖)。
  • 创建 versions/、installs/、shims/ 子目录。
  • 把 ~/.pvm/shims 与 ~/.pvm/bin 加入用户 PATH。
  • 如果系统 PATH 中有 nvm/node/python 等冲突路径,报告冲突;手动运行 pvm setup 时可选择以管理员权限把 pvm shims 前置到系统 PATH(一键安装默认不提权,仅修改用户级 PATH)。
  • 文件所有权守护:以管理员(Windows)/ sudo(macOS、Linux)模式跑完 setup 后,自动把 ~/.pvm 所有权归还给当前用户,保证之后普通权限的终端 / IDE 一切可用,不会出现"管理员装完、普通权限装包失败"的问题。
管理员还是普通用户?

日常开发用默认方式即可,全程不需要管理员权限。需要 pvm 压过系统级安装的 node / nvm(对所有用户生效)时,用 pvm setup --scope admin(Windows); 一键安装脚本对应 -Scope admin。即使以管理员安装,文件所有权也会自动 归还给你的账户,普通权限终端不受影响。

如果曾经用管理员 / sudo 安装导致普通终端装包失败,运行 pvm repair-owner 一次即可修复,详见 故障排查。

#检查 PATH

若终端找不到 pvm 或 node 等命令,运行自检:

pvm setup-path

该命令会检查并修复 PATH 配置、提示与其它版本管理器的冲突。

#验证安装

pvm version
# pvm 0.0.2
pvm doctor
# 检查 pvm 安装健康度(目录、PATH、shims 完整性)
注意

修改 PATH 后请重启终端(或 IDE)让 PATH 生效。 如果系统 PATH 冲突修复需要管理员权限,setup 会提示 UAC 弹窗。


← 上一篇:PVM 简介 下一篇:快速开始 →