volta

官方 POSIX 安装脚本。自动检测平台，下载最新版本 tarball，校验 SHA-256，并安装到 `~/.volta`，同时在 `~/.profile` / `~/.zshrc` 中写入 PATH。

--skip-setup 跳过 PATH 修改；-v 详细输出；--version X.Y.Z 锁定到特定版本

Windows PowerShell 安装命令。行为与 bash 脚本相同——下载 MSI / EXE，为当前用户设置 `VOLTA_HOME` 和 PATH。

安装最新的 Node.js LTS 版本，并设为全局默认。`node`、`npm`、`npx` 这些 shim 都会绑定到所安装的版本。

<version> 安装指定版本（例如 [email protected]）

安装指定的 Node.js 版本（例如 node@18、[email protected]、node@latest）。Volta 会同时保留所有已安装版本，通过 `package.json` 锁定即可切换。

将 `volta.node` 写入项目 `package.json`，让团队成员运行 `volta install` 时都得到这个版本。

锁定该项目使用的 npm 版本，与 Node 自带的 npm 无关。

锁定 Yarn（classic 1.x）。Yarn Berry（2+）请使用 `yarn` 和 `yarn@berry` 形式。

锁定 pnpm，使 `pnpm install` 在每台机器上都用同一版本。

安装全局 npm 包，并让 Volta 接管该工具。其二进制会通过 Volta shim 出现在 PATH 上，并记录在用户的 Volta 目录下。

-v 详细输出；--no-progress 隐藏进度显示

按指定版本安装全局包。适用于像 TypeScript 这样希望所有项目都用同一编译器的工具。

移除由 Volta 接管的全局 npm 包及其 shim。

列出 Volta 已知的全部 Node / 包管理器 / 全局工具的版本。

node；npm；yarn；pnpm；packages

只列出已安装的 Node.js 版本，并标记当前默认版本。

列出已全局安装的 npm 包及其锁定版本。

打印 Volta 在当前目录下要分发的二进制绝对路径（遵循项目的版本锁定）。

将某个 Node / 工具的发行版预先下载到 Volta 缓存中而不安装。适合离线 CI。

--platform linux-x64 覆盖目标平台

在当前项目下用 Volta 原本会使用的工具链执行任意命令，不修改当前 shell。

用显式覆盖版本运行命令，优先级高于项目锁定（适合临时兼容性检查）。

重新将 Volta 添加到 shell 配置文件（PATH + `VOLTA_HOME` 环境变量）。在 shell 升级后，或在 `volta install` 时使用了 `--skip-setup` 之后运行。

打印 Volta 版本。

查看顶层帮助，列出所有子命令。

逐步检查常见环境问题（PATH、shim 冲突、过时安装、代理问题），并给出修复建议。

显示 Volta 存放工具与 shim 的位置（POSIX 上默认 `~/.volta`，Windows 上为 `%LOCALAPPDATA%\Volta`）。

清空所有已安装的工具链（POSIX）。再把 shell 配置中的 PATH 行删掉即可完全卸载 Volta。

PowerShell 上的同样操作——清空 Volta 目录，再从 `HKCU\Environment\Path` 中删除 `Volta` 即可。