概述
单体仓库的麻烦在于包的发布面与版本关系不清，容易出现漏发、错序或日志缺失。先把包分类、选定并记录版本策略、用变更说明自动生成日志与提升、合并版本 PR 后按依赖顺序发布，可让发布过程可预期。
关键步骤
- 把包分类为已发布、私有或内部。
- 选择独立或固定版本策略并记录。
- 由变更说明自动生成日志与版本提升。
- 合并版本 PR 后按依赖顺序发布。
验证
- 共享包改动触发正确的版本提升。
- 发布顺序符合依赖图。
- 变更日志与提交一致。
- 发布运行记录哪些包被发布。
决策点
耦合松散的包宜独立版本，消费者期望同一版本线时则用固定版本；发布仅应由 CI 执行，本地发布绕过评审且易不一致。
适用范围
本条目围绕「Monorepo 版本管理工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。
npx changeset version
npx changeset publish
# publish respects the workspace dependency graph