release-it版本提示失效问题分析与解决方案

问题现象

在使用release-it进行版本发布时，开发者发现工具未按预期弹出交互式版本选择提示（如选择patch/minor/major版本），而是直接自动执行版本更新流程。该问题在Windows 10和Linux环境下均存在，涉及release-it v18.1.2版本。

技术背景

release-it作为流行的版本发布工具，其核心功能包含：

1. 版本号自动/手动升级机制
2. 变更日志生成
3. Git标签与发布流程集成
4. 插件体系扩展（如conventional-changelog插件）

常规工作流程应包含交互式版本选择环节，这是保证版本控制符合语义化版本规范的重要步骤。

问题根源

经过技术排查，发现该现象与以下因素相关：

1. conventional-changelog插件行为
   当项目集成@release-it/conventional-changelog插件时，插件会基于Git提交历史自动推荐版本升级策略（recommendedBump），这会覆盖默认的交互提示行为。

2. CI环境检测机制
   release-it在检测到CI环境变量（CI=1）时会自动禁用交互提示，但本案例发生在本地开发环境。

3. 配置缺失
   未显式配置ignoreRecommendedBump参数，导致插件自动决策流程优先于用户交互。

解决方案

方案一：禁用自动版本推荐

在.release-it.json配置文件中增加：

{
  "ignoreRecommendedBump": true
}

该配置会强制保留交互式版本选择功能，适用于需要人工确认版本变更的场景。

方案二：预设版本策略

若需保持自动化流程，可指定默认版本策略：

{
  "increment": "minor"
}

此时将跳过提示直接按minor版本升级。

最佳实践建议

1. 环境隔离
   开发环境应确保无CI相关环境变量干扰（如CI=true）

2. 配置显式声明
   明确配置是否需要交互：

   {
     "ci": false,
     "plugins": {
       "@release-it/conventional-changelog": {
         "preset": "angular"
       }
     }
   }
   

3. 版本策略选择

   • 核心库项目建议保留交互提示
   • 高频发布的工具链可采用自动策略

技术启示

该案例揭示了工具链集成时的常见问题：插件系统的默认行为可能改变主工具的核心交互逻辑。开发者需要：

1. 充分理解各插件的功能边界
2. 通过配置显式声明预期行为
3. 在复杂工作流中建立行为验证机制

release-it的灵活配置体系最终支持了不同场景下的版本发布需求，正确理解其配置优先级是解决问题的关键。