用 Changesets 管理包版本

概述

在发布时手工修改版本与变更日志，会导致版本漂移、日志不全，发布过程压力大。Changesets 把变更意图随 PR 一并记录，再由自动版本 PR 统一消费为版本提升与日志条目，让发布可审阅且可重复。

关键步骤

1. 要求改动已发布包的 PR 附带变更说明。
2. 由 version 命令把变更说明消费为版本提升与日志。
3. CI 打开版本 PR，合并后发布。
4. 核对发布版本与变更意图一致。

验证

• 每次包变更都有对应说明。
• 版本提升与日志一致更新。
• 发布流程在合并后自动进行。
• 发布版本符合预期。

注意事项

• Changesets 需要清晰的包图，未发布或私有包需额外配置。
• 它不取代语义化版本的判断，提升级别仍是人的决策。

适用范围

本条目围绕「用 Changesets 管理包版本」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。

npx changeset              # add a changeset interactively
npx changeset version      # consume into bumps + changelog
npx changeset publish      # publish changed packages