全部速查表前端開發

volta

Volta 1.x

日常 Volta CLI 命令快速參考:安裝 Node/npm/Yarn/pnpm 工具鏈、為個別專案鎖定版本、管理全域套件、疑難排解 Volta 本身——附常用參數與實作範例。

25 條命令

安裝 Volta 本身

curl https://get.volta.sh | bash

官方 POSIX 安裝腳本。偵測你的平台,下載最新發行版的 tarball,驗證 SHA-256,並安裝到 `~/.volta`,同時在 `~/.profile`/`~/.zshrc` 加入 PATH。

--skip-setup 略過 PATH 設定;-v 詳細輸出;--version X.Y.Z 鎖定特定發行版

curl https://get.volta.sh | bash -s -- --version 1.1.1
iwr https://get.volta.sh | iex

Windows 上的 PowerShell 安裝指令。行為與 bash 腳本相同——下載 MSI/EXE,為當前使用者設定 `VOLTA_HOME` 與 PATH。

iwr https://get.volta.sh | iex

安裝 Node

volta install node

安裝最新的 Node.js LTS 版本並設為全域預設。`node`、`npm`、`npx` shim 會指向這個版本。

<version> 安裝特定版本(例如 [email protected]

volta install node@20
volta install node@<version>

安裝特定 Node.js 版本(例如 node@18、[email protected]、node@latest)。Volta 會並存保留所有已安裝版本;可在 `package.json` 設定以切換。

volta install [email protected] && volta install [email protected]

為專案鎖定版本

volta pin node@<version>

把 `volta.node` 寫入專案的 `package.json`,讓每位團隊成員執行 `volta install` 時都使用這個版本。

volta pin node@20 && volta pin npm@10 && volta pin [email protected]
volta pin npm@<version>

為此專案鎖定 npm 版本,與 Node 內建的 npm 無關。

volta pin yarn@<version>

鎖定 Yarn(Classic 1.x)。若為 Yarn Berry(2+)請使用 `yarn` 與 `yarn@berry` 形式。

volta pin pnpm@<version>

鎖定 pnpm,使每台機器執行 `pnpm install` 時都使用相同版本。

全域套件

volta install <package>

安裝全域 npm 套件並納入 Volta 管理。執行檔會透過 Volta shim 加入 PATH,並在使用者的 Volta home 中被追蹤。

-v 詳細輸出;--no-progress 隱藏進度 UI

volta install typescript tsx vitest
volta install <package>@<version>

以鎖定的版本安裝全域套件。適合如 TypeScript 等需要所有專案統一編譯器的工具。

volta install [email protected]
volta uninstall <package>

移除由 Volta 管理的全域 npm 套件及其 shim。

volta uninstall typescript

管理已安裝工具

volta list

列出 Volta 已知的 Node/套件管理程式/全域工具版本。

node;npm;yarn;pnpm;packages

volta list node && volta list packages
volta list node

只列出已安裝的 Node.js 版本,並標示目前預設的版本。

volta list node
volta list packages

列出全域安裝的 npm 套件及其鎖定版本。

volta list packages
volta which <tool>

印出 Volta 在目前目錄下會分派到的執行檔絕對路徑(會參考專案層級的鎖定)。

volta which node && volta which npm && volta which yarn
volta fetch

預先下載 Node/工具發行版到 Volta 的快取中而不安裝。適合離線 CI。

--platform linux-x64 覆寫目標平台

volta fetch [email protected] --platform linux-x64

專案工具

volta run <command>

使用 Volta 在當前專案會套用的工具鏈執行任意指令,而不需要修改 shell。

volta run --node 18 --yarn 1.22 npm test
volta run --node <v> --npm <v> --yarn <v> --pnpm <v> <cmd>

以明確覆寫值執行指令(會優先於專案鎖定;適合一次性相容性檢查)。

volta run --node 18 --npm 9 npm run build
volta setup

重新將 Volta 加入 shell 啟動檔(PATH + `VOLTA_HOME` 環境變數)。在升級 shell 後,或 `volta install` 以 `--skip-setup` 執行後,執行此指令。

volta setup

診斷

volta --version

印出 Volta 版本。

volta --version
volta --help

顯示頂層說明,列出所有子指令。

volta --help
volta doctor

逐步檢查常見環境問題(PATH、shim 衝突、過期安裝、代理問題)並建議修正方式。

volta doctor
echo $VOLTA_HOME

顯示 Volta 儲存工具與 shim 的位置(POSIX 預設 `~/.volta`,Windows 為 `%LOCALAPPDATA%\Volta`)。

echo $VOLTA_HOME && ls $VOLTA_HOME/tools/image/node

解除安裝

rm -rf $VOLTA_HOME

清除所有已安裝的工具鏈(POSIX)。再從 shell 啟動檔移除 PATH 行即可完全移除 Volta。

rm -rf $VOLTA_HOME && sed -i '/volta/d' ~/.zshrc
Remove-Item -Recurse -Force $env:VOLTA_HOME

PowerShell 上的同樣操作——刪除 Volta home,再從 `HKCU\Environment\Path` 刪除 `Volta` 項目。

Remove-Item -Recurse -Force $env:VOLTA_HOME

相關命令速查

關於 Volta

Volta 是一個無負擔的 JavaScript 工具管理程式,由 Chuck Pierce 開發,於 2019 年首次發佈。它會先把 Node.js、npm、Yarn 及其他 JS 工具安裝一次(全域),再根據每個專案 `package.json` 中一個小型的 `volta` 欄位,自動為該專案選用正確版本。目前穩定版線為 Volta 1.x。與 nvm 或 n 不同,Volta 會追蹤所選的工具(不只 Node),並內建以 Rust 撰寫的高速 shim 引擎,可在毫秒等級內攔截 CLI 呼叫並導向正確的執行檔。Volta 適合這種情境:clone 一個 repo、執行 `yarn install`,團隊每個人自動用相同的 Node + Yarn 版本,免去手動切換。Volta 不是 `nvm` 式的 Node 版本管理器——它不會提供互動式 shell 讓你選版本,它只會強制執行 `package.json` 所宣告的版本。由於所有工具鏈都集中在單一使用者可寫入的目錄(預設 `~/.volta`),解除安裝只需刪除一個目錄。所有下載都透過 HTTPS 從 `volta.sh`/GitHub 取得;沒有遙測、不會上傳任何資料。

速查頁版本 1.0.0