zzreo
← 全部文章

volta 常用命令手册

本文目录
  1. 1. volta 是什么
  2. 2. 适合什么场景
  3. 3. 常用命令
    1. 查看状态
    2. 安装 Node.js
    3. 安装包管理器
    4. 安装全局 CLI 工具
    5. 查看某个工具安装情况
    6. 固定当前项目的 Node 版本
    7. 卸载工具
  4. 4. 常见工作流
    1. 给前端项目固定 Node 版本
    2. 安装并固定 pnpm
    3. 给机器装常用前端工具
  5. 5. 常见目录
  6. 6. 你最常用的几条
  7. 7. 和 nvm 的区别
  8. 8. 注意事项

1. volta 是什么

volta 是一个 Node.js 工具链管理器,主要用来:

  • 管理 Node.js 版本
  • 管理 npm / yarn / pnpm
  • 管理全局安装的前端 CLI 工具
  • 按项目自动切换 Node 版本

它的核心特点是:快、稳定、对前端开发很友好。


2. 适合什么场景

  • 你同时维护多个前端项目
  • 不同项目要求不同 Node 版本
  • 你不想全局乱装 node、npm、pnpm
  • 你想稳定管理 vite、typescript、pnpm、yarn 这类工具

3. 常用命令

查看状态

volta --version
volta list
volta which node
volta which npm

说明:

  • volta list:查看当前安装和固定的工具
  • volta which node:查看当前 node 真实路径

安装 Node.js

volta install node
volta install node@20
volta install node@20.18.0

说明:

  • node:安装最新版
  • node@20:安装某个主版本
  • node@20.18.0:安装精确版本

安装包管理器

volta install npm
volta install yarn
volta install pnpm
volta install pnpm@9

说明:

  • 用 volta 安装后,版本会受它统一管理

安装全局 CLI 工具

volta install typescript
volta install vite
volta install create-vite
volta install @vue/cli

说明:

  • 这些工具会和 Node 版本关联得更稳定
  • 比直接 npm install -g 更干净

查看某个工具安装情况

volta list node
volta list npm
volta list pnpm
volta list typescript

固定当前项目的 Node 版本

cd your-project
volta pin node@20.18.0
volta pin pnpm@9.12.0

说明:

  • 会把配置写进项目的 package.json
  • 进入项目目录后,volta 会自动按这个版本运行

卸载工具

volta uninstall node
volta uninstall pnpm
volta uninstall typescript

说明:

  • 删除不再使用的版本或工具

4. 常见工作流

给前端项目固定 Node 版本

cd your-project
volta install node@20.18.0
volta pin node@20.18.0
node -v

安装并固定 pnpm

volta install pnpm@9
volta pin pnpm@9.12.0
pnpm -v

给机器装常用前端工具

volta install typescript
volta install vite
volta install create-vite

5. 常见目录

~/.volta

常见内容:

  • ~/.volta/tools:安装的 Node 和工具
  • ~/.volta/bin:命令入口
  • ~/.volta/cache:缓存

6. 你最常用的几条

volta list
volta install node@20
volta install pnpm
volta install typescript
volta pin node@20.18.0
volta pin pnpm@9.12.0
volta which node
volta uninstall typescript

7. 和 nvm 的区别

简单理解:

  • nvm:偏传统,切换版本常靠 shell
  • volta:更偏“工具链管理”,项目自动切换体验更好

如果你主要做前端工程化,volta 通常更省心。


8. 注意事项

  • volta pin 会改项目的 package.json
  • 如果 node -v 不符合预期,先看:
volta list
volta which node
echo $PATH
  • 如果你之前同时装过 nvm、fnm、brew node,要注意路径优先级冲突