如何通过CI/CD配置使用Lerna发布指定包并解决版本冲突

API 探路者

2026-7-26

问题背景与疑问

我在私有registry中搭建了一个monorepo，供多位开发者在packages目录下创建独立组件。CI/CD流水线配置为提交至develop分支时发布包，每周新增的组件需要发布初始版本。

当前lerna.json已配置为独立版本控制：

{
  "$schema": "node_modules/lerna/schemas/lerna-schema.json",
  "useWorkspaces": true,
  "packages": [
    "packages/*"
  ],
  "version": "independent"
}

初始合并时所有包版本为1.0.1-alpha.0，执行lerna publish后包被发布为1.0.1，但develop分支仓库中仍保留1.0.1-alpha.0版本。后续修改任意包并提交至develop时，流水线发布失败，提示版本1.0.1已存在于registry，必须删除所有包才能重新发布。

我的疑问：

若修改Package1版本为1.0.2-alpha.0并提交，流水线是否仅发布该变更包，生成1.0.2版本，同时忽略其余包？还是会覆盖已发布版本？
如何通过CI/CD流水线实现「仅发布变更包、保留仓库版本记录、避免版本冲突」的目标？

项目目录结构：根目录下包含packages文件夹，内部是各个独立组件包（如Package1、Package2等）。

当前使用的GitLab CI脚本（gitlab-ci.yml）：

script:
    - npm install
    - npx lerna run build 
    - echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}">.npmrc
    - npx lerna publish --yes --cd-version patch --skip-git

解答与解决方案

关于你的第一个疑问

仅修改Package1的版本为1.0.2-alpha.0提交后，不会自动只发布这个包，反而会触发所有包的版本更新尝试——因为当前CI脚本里用了--cd-version patch，加上--skip-git会忽略仓库里的版本记录，Lerna会默认尝试给所有包打patch版本（比如把已发布过的1.0.1升级到1.0.2），这就会导致重复版本冲突，若私有registry允许覆盖，还会出现覆盖已发布版本的情况。

核心问题分析

当前CI脚本的两个致命问题：

--skip-git参数：跳过了Git版本更新和提交，导致仓库里的package.json版本永远停留在alpha版本，Lerna每次发布都无法基于仓库的已更新版本判断哪些包需要发布，只能盲目尝试升级所有包版本。
--cd-version patch固定升级规则：在独立版本控制模式下，应该让Lerna自动检测变更包，而不是强制所有包升级patch版本。

具体解决方案

1. 调整Lerna发布命令，修复版本同步问题

修改CI脚本中的lerna publish命令，让Lerna自动识别有变更的包，同时将版本更新提交回Git仓库：

script:
    - npm install
    - npx lerna run build 
    - echo "//${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/:_authToken=${CI_JOB_TOKEN}">.npmrc
    # 关键修改：去掉--skip-git，用--no-push避免CI自动推送到分支（可根据权限调整），让Lerna自动检测变更包
    - npx lerna publish --yes --no-push --ignore-scripts --registry=https://${CI_SERVER_HOST}/api/v4/projects/${CI_PROJECT_ID}/packages/npm/

参数说明：

--no-push：避免CI自动推送版本更新到Git分支（如果CI权限允许推送，也可以去掉这个参数）
--ignore-scripts：跳过包的prepublish等脚本（如果你的build已经在前面执行过，避免重复执行）
指定--registry：确保发布到私有仓库，避免依赖全局配置

2. 统一仓库与registry的版本记录

现在仓库里的包版本还是1.0.1-alpha.0，但registry已经有1.0.1，需要先手动同步：

执行lerna version --no-git-tag-version --exact，将所有包的版本更新为已发布的1.0.1，然后提交到develop分支。
后续新增组件时，直接设置初始版本为1.0.0（不要用alpha版本），或者用lerna create自动生成初始版本。

3. 新增组件的初始版本发布规则

如果需要每周统一发布新增组件的初始版本，可采用以下两种方式：

在CI中加入Git diff检测逻辑：识别packages目录下新增的文件夹，对新增包执行lerna publish --force-publish=[新增包名] --yes
在新增组件的PR中，手动将该包的版本设置为初始正式版本（如1.0.0），CI会自动检测到这个变更并发布。

4. 版本冲突兜底处理

如果遇到版本已存在的错误，可在CI脚本中加入版本检查逻辑，或使用lerna publish --force-publish=[指定包名]仅发布目标包（仅在确认版本需要修复或覆盖时使用）。

内容的提问来源于stack exchange，提问作者Sudarshan

如何通过CI/CD配置使用Lerna发布指定包并解决版本冲突

关于你的第一个疑问 #

核心问题分析 #

具体解决方案 #

1. 调整Lerna发布命令，修复版本同步问题 #