Release-Please Action v4版本检测历史发布的兼容性问题解析

Release-Please Action作为自动化版本发布工具，其v4版本引入了一个重要的非向后兼容变更：默认情况下不再包含组件名称(component)作为标签前缀。这一变更会导致在检测历史版本时出现异常，特别是对于经历过仓库或模块重命名的项目。

问题现象

当项目从v3升级到v4后，工具会错误地识别历史版本号。典型表现为：

1. 版本号回退（如从3.12.2回退到3.0.0）
2. 变更日志生成不正确
3. 无法正确识别最近的发布版本

根本原因

v4版本默认将include-component-in-tag参数设为false，这与v3版本的默认行为相反。当项目历史中存在以下情况时，该变更会导致版本检测异常：

• 项目或模块曾经重命名
• 使用过带组件前缀的标签格式（如my-component-v1.0.0）
• 混合使用过带/不带组件前缀的标签

解决方案

在v4版本的配置中显式设置：

include-component-in-tag: true

技术背景

Release-Please的版本检测机制依赖Git标签历史。当include-component-in-tag为true时：

1. 工具会同时匹配带组件前缀和不带前缀的标签
2. 优先选择版本号最高的有效标签
3. 确保与历史发布保持兼容

对于复杂项目（特别是经历过重命名的），建议：

1. 统一历史标签格式
2. 在升级前检查历史标签模式
3. 必要时手动创建.release-please-manifest.json文件明确指定基准版本

最佳实践

1. 升级前检查现有标签格式：

git tag -l | sort -V

2. 对于新项目，建议保持默认配置（不包含组件名）

3. 对于现有项目，建议在升级到v4时：

- uses: google-github-actions/release-please-action@v4
  with:
    include-component-in-tag: true
    release-type: node

通过理解这一变更的技术背景和影响范围，开发者可以更顺利地完成版本升级，确保自动化发布流程的稳定性。