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.1iwr https://get.volta.sh | iexWindows 上的 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@20volta 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 yarn@<version>鎖定 Yarn(Classic 1.x)。若為 Yarn Berry(2+)請使用 `yarn` 與 `yarn@berry` 形式。
volta pin [email protected]全域套件
volta install <package>安裝全域 npm 套件並納入 Volta 管理。執行檔會透過 Volta shim 加入 PATH,並在使用者的 Volta home 中被追蹤。
-v 詳細輸出;--no-progress 隱藏進度 UI
volta install typescript tsx vitestvolta 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 packagesvolta list node只列出已安裝的 Node.js 版本,並標示目前預設的版本。
volta list nodevolta list packages列出全域安裝的 npm 套件及其鎖定版本。
volta list packagesvolta which <tool>印出 Volta 在目前目錄下會分派到的執行檔絕對路徑(會參考專案層級的鎖定)。
volta which node && volta which npm && volta which yarnvolta 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 testvolta run --node <v> --npm <v> --yarn <v> --pnpm <v> <cmd>以明確覆寫值執行指令(會優先於專案鎖定;適合一次性相容性檢查)。
volta run --node 18 --npm 9 npm run buildvolta setup重新將 Volta 加入 shell 啟動檔(PATH + `VOLTA_HOME` 環境變數)。在升級 shell 後,或 `volta install` 以 `--skip-setup` 執行後,執行此指令。
volta setup診斷
volta --version印出 Volta 版本。
volta --versionvolta --help顯示頂層說明,列出所有子指令。
volta --helpvolta doctor逐步檢查常見環境問題(PATH、shim 衝突、過期安裝、代理問題)並建議修正方式。
volta doctorecho $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' ~/.zshrcRemove-Item -Recurse -Force $env:VOLTA_HOMEPowerShell 上的同樣操作——刪除 Volta home,再從 `HKCU\Environment\Path` 刪除 `Volta` 項目。
Remove-Item -Recurse -Force $env:VOLTA_HOME相關命令速查
npm
日常 npm CLI 命令快速參考:init/install/add/remove/update/scripts/run/publish/audit,加上 lockfile、registry、cache 管理——附常用參數與實作範例。
34 條命令
npm 10+
yarn
日常 Yarn CLI 命令快速參考(涵蓋 Yarn Classic 1.x 與 Yarn Berry 2/3/4):install/add/remove/run/workspaces、lockfile、Plug'n'Play,以及 Berry 設定——附常用參數與實作範例。
33 條命令
Yarn 1.x (classic) / Yarn 4 (berry)
pnpm
pnpm 快速參考:install / add / remove / update、scripts、workspaces、store 與 cache、config——聚焦於 GitHub 站 pnpm 倉庫的工作流,附參數與實作範例。
31 條命令
pnpm 9+
npx
npx 命令快速參考:執行一次性套件執行檔、搭建專案、管理 npx 快取、鎖定版本,以及避免互動式 CLI 的陷阱——附常用參數與實作範例。
25 條命令
npx 10+ (shipped with npm)
vite
Vite CLI 命令快速參考:開發伺服器、build、preview、相依預先打包、plugin 管理、環境變數與專案檢視——附常用參數與實作範例。
30 條命令
Vite 5+
商標與使用聲明
本批命令列工具速查手冊為開源社群參考資料。文中涉及的各工具的名稱、標識、商標(如 Git™、Docker™、Kubernetes®、kubectl、PostgreSQL®、MySQL®、Redis™、MongoDB®、Linux™、PowerShell™、Vim™ 等)均歸對應權利人所有,此處僅為識別與參考之目的使用。
本速查手冊的全部內容均為獨立編寫的簡化自包含參考,**與任何官方文件不存在隸屬、被認可或引用關係**。命令列表、參數說明、範例均為作者原創簡化表達;如需權威資訊,請參閱各工具的官方文件。
命令語法與參數可能在不同工具版本中有所差異。所示版本標籤對應穩定發佈版本;其他版本行為可能有所不同。本速查手冊**不代表**商標權利人的任何偏好或推薦。
如商標或版權方認為本站部分內容存在權益侵害,請發送電郵至[email protected],我們在收到有效權屬證明後,會在合理期限內修改或移除相關內容。
本網站不對因使用本站資訊而產生的任何直接或間接損失承擔法律責任。
關於 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