GitLab Changelog生成异常：无变更提示与版本格式报错排查

问题1：Changelog持续显示无变更 #

原因分析 #

• 提交信息不符合约定式提交规范：只有格式为[类型]: [描述]的提交才会被工具识别，且类型必须在changelog_config.yml的types列表内。你的提交记录里added a template、new changelog file Changelog: feat这类格式不符合要求，无法被抓取。
• 版本区间内无合规提交：glab changelog generate --version v1.0.3会生成上一个版本（v1.0.2）到v1.0.3之间的变更，需确认该区间内的提交是否都符合格式要求。

解决方案 #

1. 修正提交信息格式
   所有需要纳入Changelog的提交必须遵循类型: 描述的格式，类型仅限你配置的feat/fix/docs/refactor/performance之一。例如：

   • 错误：added a template → 正确：feat: add template
   • 错误：new changelog file Changelog: feat → 正确：feat: add new changelog file

2. 确认版本区间的提交
   执行以下命令查看v1.0.2到v1.0.3之间的所有提交，检查格式是否合规：

   git log v1.0.2..v1.0.3 --oneline
   

3. 简化模板排查逻辑问题
   临时修改.gitlab/changelog_config.yml的模板，直接输出所有捕获到的条目，验证是否是模板逻辑导致无内容：

   template: |
     {% if entries %}
     {% each entries %}
     - {{ title }} ({{ commit.id }})
     {% end %}
     {% else %}
     No changes.
     {% end %}
   

   重新生成Changelog，若有输出则说明原模板的分类逻辑存在问题，再逐步调整。

问题2：未指定版本时触发格式错误 #

原因分析 #

glab changelog generate不带--version参数时，工具会尝试自动推断版本，但部分旧版本glab的自动推断逻辑存在bug，导致传递给GitLab API的版本格式不符合要求，即使本地tag格式合规。

解决方案 #

1. 显式指定版本参数
   无论生成已发布还是未发布版本的Changelog，都显式声明--version，可选通过--from指定起始版本（不指定则默认使用最新tag）：

   • 生成从最新tag（v1.0.3）到HEAD的未发布版本Changelog：

     glab changelog generate --version v1.0.4
     

   • 生成v1.0.2到v1.0.3之间的Changelog：

     glab changelog generate --version v1.0.3 --from v1.0.2
     

2. 升级glab到最新版本
   旧版本glab可能存在兼容性问题，执行升级命令：

   glab update
   

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