Lerna-Lite 5.0发布解析

总结摘要

Lerna-Lite 在 2026 年 4 月 2 日发布 v5.0.0。

就官方 release 和迁移说明来看，这个版本最重要的变化有三项：

Node.js 运行要求提升到 ^22.17.0 || >=24.0.0
Conventional Changelog 的 legacy 外部配置方式被移除
lerna publish --remove-package-fields 这个已弃用参数被正式下线

更新内容

根据官方 release notes 和迁移说明，这次 v5.0.0 的变化主要集中在以下几个方面：

运行环境
旧配置兼容
内部实现

Node.js 要求提升

Lerna-Lite 5.0 现在要求 Node.js 版本为：

^22.17.0 || >=24.0.0

官方给出的背景很直接：Node.js 20 即将在 2026 年 4 月结束支持，因此项目在这个 major 版本里同步提高了运行时要求。

一些旧兼容能力被正式移除

这次升级同时清理了两类已经进入弃用状态的旧用法：

移除了 Conventional Changelog 的旧式 legacy API
使用自定义 changelogPreset 时，不再支持从外部文件读取配置，改为只接受 lerna.json 中的配置
去年已经改名并废弃的 lerna publish --remove-package-fields 现在被正式移除
发布相关场景应改用 --strip-package-keys

内部实现更偏向原生 Node 能力

官方说明里提到，Node 门槛上调后，项目可以直接使用更多原生 Node.js 能力，例如：

util.styleText()
import.meta.dirname

对应到 release notes 中，还能看到这些变化已经落到了实际代码和构建层：

使用原生 import.meta.dirname/filename
构建侧改用 module --nodenext
tinyrainbow 被原生 util.styleText() 替换

迁移影响与项目取向

如果项目已经在生产环境里使用 Lerna-Lite，这次升级最先要看的不是新特性，而是兼容性。

Node 版本是否达标

这是这次发布里最直接的一项变化。

如果 CI、开发机、构建镜像或发布流水线还停留在 Node 20，那么升级到 Lerna-Lite 5.0 之前就需要先调整运行环境，否则会先卡在基础运行条件上。

自定义 changelog 配置是否还依赖旧写法

如果你的发布流程依赖 Conventional Changelog 的旧式外部配置文件，这次升级会直接影响相关流程。

官方已经把这条路收掉，新的要求是把相关配置统一放回 lerna.json。

这类变化不一定会在安装阶段暴露出来，更可能是在版本发布或 changelog 生成时出现兼容问题。

发布脚本里是否仍在使用废弃参数

--remove-package-fields 现在已经不再可用。

对脚本历史较长的 monorepo 来说，这类变更很容易漏看，因为相关参数往往不只写在 README 里，也可能写在 CI 配置、npm scripts 或内部发布脚本中。

哪些项目会先受到影响

从 release 内容看，这次升级会先影响以下几类项目。

正在维护 monorepo / workspace 的团队

Lerna-Lite 本身就是为 monorepo/workspace 管理和发布设计的工具，核心场景包括：

多包版本管理
多包发布
按包执行脚本
变更检测与差异查看
watch / run / exec 等工作区操作

如果仓库已经把 Lerna-Lite 接入发布链路，那么 v5.0.0 的影响会先落在 Node 环境和发布配置上。

从原版 Lerna 迁移过来的用户

Lerna-Lite 的官方定位一直很明确：它是更轻量、更模块化的 Lerna 替代方案，不强依赖 Nx，并且把命令拆成按需安装的可选包。

这类项目通常更依赖版本发布、changelog 和 workspace 管理能力，因此更需要留意 v5.0.0 对旧参数和旧配置方式的清理。

依赖现代包管理器特性的用户

官方 README 强调，Lerna-Lite 支持 catalog: 与 workspace: 协议，并覆盖 pnpm、Yarn、Bun 等场景。

对这类项目来说，v5.0.0 更像是一次工具链基线更新，而不是单个功能点的增量发布。

适用场景与迁移影响

从官方 README 可以确认，Lerna-Lite 主要适合这些场景：

已经有 npm、pnpm、Yarn 或 Bun workspace 的项目
只想引入自己需要的命令，而不是安装一个"大而全"的 monorepo 工具
重点使用 version、publish、run、exec、watch 这类能力
不希望因为使用原版 Lerna 而额外引入 Nx 依赖

这次升级反映出的方向

从官方表述看，这次 major release 延续的是项目过去几年的路线：

继续摆脱旧兼容层和历史包袱
借助更高版本的 Node.js 使用更多原生能力，减少额外依赖

这些变化和 README 里的定位是一致的，也就是继续维持"更轻、更模块化、依赖更少"的方向。

迁移时应优先检查什么

如果你准备升级到 v5.0.0，至少应先核对下面几项：

Node.js 运行环境是否已经升级到 ^22.17.0 || >=24.0.0
CI/CD 镜像与本地开发环境是否一致
lerna.json 是否承担自定义 changelog 配置，而不是外部 legacy 配置文件
发布脚本中是否仍在使用 --remove-package-fields
与 changelog 相关的依赖，例如 Commitlint 或 conventional-changelog-conventionalcommits，是否已经更新到兼容版本

背景介绍

Lerna-Lite 的官方定位是更轻量的 Lerna 替代方案。

它主要用于管理 monorepo 或 workspace 项目里的版本、发布和多包脚本执行。

和原版 Lerna 相比，它更强调按需安装，不强依赖 Nx，并且能配合 pnpm、Yarn、Bun 等现代包管理器使用。

放到这次 v5.0.0 来看，这次更新延续的还是同一条路线：提高 Node 基线，清理旧兼容层，继续维持轻量和模块化的工具定位。

来源说明

本文内容基于以下一手来源整理：

官方 Release: https://github.com/lerna-lite/lerna-lite/releases/tag/v5.0.0
官方 README: https://github.com/lerna-lite/lerna-lite
官方迁移说明: https://github.com/lerna-lite/lerna-lite/wiki/all-Release-Migrations

作者介绍

我是农村程序员，独立开发者，前端之虎陈随易，技术群与交朋友请在个人网站 👇 联系我 ✌️

个人网站 1️⃣：https://chensuiyi.me
个人网站 2️⃣：https://me.yicode.tech