volta 常用命令手册
本文目录
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:偏传统,切换版本常靠 shellvolta:更偏“工具链管理”,项目自动切换体验更好
如果你主要做前端工程化,volta 通常更省心。
8. 注意事项
volta pin会改项目的package.json- 如果
node -v不符合预期,先看:
volta list
volta which node
echo $PATH
- 如果你之前同时装过
nvm、fnm、brew node,要注意路径优先级冲突