volta pin
volta pin
命令将更新项目的 package.json
文件以使用所选版本的工具。它具有以下语法:
bash
固定您项目的运行时或包管理器
用法:
volta pin [FLAGS] <tool[@version]>...
标志:
--verbose 启用详细诊断
--quiet 防止不必要的输出
-h, --help 打印帮助信息
参数:
<tool[@version]>... 要固定的工具,如 `node@lts` 或 `yarn@^1.14`。
注意
volta pin
仅适用于 Node 和包管理器(例如 npm 或 Yarn)。对于依赖项,您应该使用npm install
或yarn add
来更新所选版本。
示例
固定 Node.js
bash
# 固定最新的 LTS 版本 Node
volta pin node
# 固定特定版本的 Node
volta pin node@16.14.2
# 固定 Node 版本范围
volta pin node@16
当您固定 Node.js 版本时,Volta 在项目的 package.json
文件中添加一个 volta
部分:
json
{
"volta": {
"node": "16.14.2"
}
}
固定包管理器
bash
# 固定最新的 npm 版本
volta pin npm
# 固定特定版本的 Yarn
volta pin yarn@1.22.19
# 固定 pnpm(如果启用了功能标志)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0
固定包管理器将它们添加到 package.json
中的 volta
部分:
json
{
"volta": {
"node": "16.14.2",
"npm": "8.5.0"
}
}
使用场景
volta pin
命令对以下方面至关重要:
- 在您的团队中创建一致的开发环境
- 确保在项目上工作的每个人都使用相同的 Node.js 版本和包管理器
- 防止"在我的机器上可以工作"的问题
- 记录您的项目与哪个 Node.js 版本兼容
固定的效果
当您固定工具时:
- 如果您还没有该工具,它会自动安装
- 版本被写入
package.json
的volta
部分 - 任何使用 Volta 在项目上工作的人都将自动使用指定的版本
- 使用 Volta 的 CI/CD 系统将使用正确的版本
固定的工具优先于使用 volta install
设置的默认工具版本。
package.json 详情
package.json
中的 volta
部分可以包括:
json
{
"volta": {
"node": "16.14.2", // 确切版本
"npm": "^8.5.0", // Semver 范围
"yarn": "1.22.19", // 确切版本
"pnpm": "7.0.0" // 如果启用了 pnpm 支持
}
}
版本说明符可以是:
- 确切版本:
16.14.2
- 主版本:
16
- 主.次版本:
16.14
- Semver 范围:
^16.14.0
- 标签:
lts
、latest