跳到主内容
版本:11.x

pnpm version

添加于:v11.0.0

更新软件包版本。

pnpm version <newversion>
pnpm version <major|minor|patch|premajor|preminor|prepatch|prerelease|from-git>

<newversion> 可以是上述任何版本号,也可以是显式的语义版本号(例如 1.2.3)。 支持工作区和 workspace: 协议,因此工作区包之间的交叉引用会正确更新。

在 git 仓库中运行时,pnpm version 会为版本更新创建一个 git 提交和一个带注释的标签。 工作树必须是干净的(见下文的 --no-git-checks),并且可以使用 --no-git-tag-version 禁用提交/标签。 在递归模式下,Git 提交和标签总是会被跳过,因为在一次运行中多个软件包可能会升级到不同的版本。

使用方法

pnpm version patch
pnpm version minor
pnpm version major
pnpm version 2.0.0
pnpm version prerelease --preid beta

配置项

--preid <prerelease-id>

用作语义版本号中预发布部分前缀的“预发布标识符”。

pnpm version prerelease --preid beta

--message, -m <message>

提交消息。 消息中的任何 %s 都会被替换为新版本。 默认值为 %s

pnpm version patch --message "chore: release v%s"

--tag-version-prefix <prefix>

创建 Git 标签时使用的前缀。 默认值为 v(例如 v1.2.3)。 设置为空字符串可完全删除前缀。

--no-git-tag-version

不要为版本更改创建 git 提交或标签。

--no-commit-hooks

提交版本号提升时跳过 git 提交钩子(--no-verify)。

--sign-git-tag

使用 GPG 对生成的 git 标签进行签名(git tag -s)。

--no-git-checks

版本号提升之前,不要检查工作树是否干净。

--allow-same-version

允许将版本设置为当前版本。 这对于持续集成(CI)流水线非常有用。

--recursive, -r

将版本更新应用于工作区中的每个软件包(可以使用 --filter 缩小范围)。 递归模式下会跳过 Git 提交和标签创建。

--json

以 JSON 格式输出已升级的软件包列表。