html

从本地到 NPM：版本管理与自动化发布教程

写在前面：在完成了主要组件的打包建立与测试后：工程化建立与打包教程》），我们的组件库 my-antd-ui 正式进入了最终也是最关键的阶段——版本发布。不过，这不仅是把代码传到网上那么简单，更是要性同步：如果你改了 utils 包。它会自动提醒你受影响的 components 包是否也需要升级。怎么说呢，

. 主要配置速览

我们的配置文件位于 .changeset/config.json，它是整个发布程序的“大脑”：

{ "$schema": "https://unpkg.com/@changesets/config@./schema.json","changelog": "@changesets/cli/changelog",// 指定生成 CHANGELOG.md 的方式 "commit": false,// 执行 version 命令时是否自动提交 git commit "fixed":,// 强制同步版本的包组 "linked":,// 关联版本的包组 "access": "restricted",// 发布权限：public 或 restricted "baseBranch": "master",// 项目主分支。用于对比变更 "updateInternalDependencies": "patch",// 内部依赖更新时的版本提高策略 "ignore": // 忽略版本管理的包}

🧪 详细说明：updateInternalDependencies

假设我们有两个包，一个依赖另一个：

pkg-a @ version .pkg-b @ version . depends on pkg-a at range `^.

当我们同时为两者发布 Patch 变更时：

• 设置为 "minor"：pkg-b 对 pkg-a 的依赖将保持 ^.。依赖范围不移动，因为变更只是 Patch 级别。未达到 Minor 阈值，。

. 规范流程与后续建议

在实际开发中，建议遵循以下“三部曲”：

1. Record ：运行 npx changeset。它会启动交互式菜单：

   • 选包：按 空格 勾选本次有变动的包。
   • 定级：选择变更等级。Major 、Minor 、Patch。
   • 写：输入简明的变更描述。随后它会在 .changeset/ 目录下生成一个随机命名的 .md 文件。这个文件就是你发布前的**“存证”**。

2. Version ：在准备发布前，运行 npx changeset version。说起来，工具会“消费”掉刚才生成的那些 ` .md` 文件。自动更新相关包的 `package.json` 版本号，并同步生成/更新 `CHANGELOG.md`。说起来，

3. Publish ：运行 pnpm build。确保产物最新，接下来执行 npx changeset publish 将你的组件库一键推送到 NPM 仓库。

五、实战演练：发布一个 Patch 补丁版本

在完成文档更新或修复微小 Bug 后需要发布一个 Patch版本。

---