pnpm change

自 v11.13.0 起提供

记录一个变更意图：变更影响哪些包、每个包的提升类型，以及会成为变更日志条目的摘要。意图文件以 changesets 格式写入 .changeset/。

pnpm change [--bump <type>] [--summary <text>] [<pkg>...]
pnpm change status

变更意图稍后由 pnpm version -r 消费。整个工作流参见发布管理。

用法

不带参数运行以交互式记录一个意图：

pnpm change

系统会问你三个问题：

1. 此变更影响哪些包？ 自与 main（或 master）的合并基点以来发生变更的包会被预选。
2. 哪些包应做 major 提升？，随后对 minor 做同样的询问。剩下的都按 patch 提升。
3. 变更摘要，它会成为变更日志条目。

结果是一个形如 .changeset/calm-cats-resolve.md 的文件：

---
"@example/core": minor
"@example/cli": patch
---

Added a `--watch` flag to the build command.

将此文件与你的变更一起提交。

将包名与 --bump 和 --summary 一起传入，可在不提示的情况下记录一个意图，这在脚本中很有用：

pnpm change --bump patch --summary "Fixed a crash on empty input" @example/core

子命令

status

显示待处理的变更意图及其生成的发布计划。

pnpm change status

Pending change intents:
  .changeset/calm-cats-resolve.md

Release plan:
  @example/core: 1.2.0 → 1.3.0 (minor, via intent)
  @example/cli: 0.4.1 → 0.4.2 (patch, via intent+dependencies)

每次提升的原因属于以下之一：intent（变更意图点名了该包）、dependencies（依赖方被传播拉入）、fixed（某个固定组的伴随项），或 epic（epic 的重新基线）。

选项

--bump

被点名包的提升类型：none、patch、minor 或 major。none 记录一次明确的拒绝，表示该变更无需发布。

--summary

变更日志条目的摘要。与包名一起使用时，以非交互方式运行该命令。

按目录引用包

当两个工作区项目发布相同的名称时，可改为通过工作区相对目录来引用某个包，并带有 ./ 前缀：

---
"./packages/cli": minor
---

这是 pnpm 对 changesets 格式所做的唯一一项附加扩展。当名称有歧义时，pnpm change 会自动写入它。