（3489期）Semver Helper – SemVer 版本决策速查手册

SemVer 版本决策速查手册 Semantic Versioning 2.0.0 速查指南，通过决策树和实例快速判断 MAJOR/MINOR/PATCH 版本升级场景。 使用说明 核心用法 semver-helper 是面向软件版本管理的实用参考工具，严格遵循 Semantic Versioning 2.0.0 规范。核心功能围绕版本号 MAJOR.MINOR.PATCH 的升级决策展开： MAJOR (X.0.0): 破坏性变更，用户代码可能不兼容 MINOR (0.X.0): 向后兼容的新功能 PATCH (0.0.X): 向后兼容的问题修复 工具提供可视化决策树，从"是否影响用户依赖"开始层层递进，最终指向正确的版本升级级别。同时包含丰富的真实案例（函数删除、API 格式变更、新增 CLI 参数等）、预发布版本命名规范（alpha/beta/rc），以及常见边界情况的处理原则。 显著优点 决策效率高：决策树将复杂的版本判断简化为 2-3 个 Yes/No 问题 案例覆盖全面：涵盖 API 变更、依赖升级、安全修复等 20+ 实际场景 反模式警示：明确列出 4 类常见错误，防止版本语义混乱 预发布支持：完整说明 alpha/beta/rc 的使用时机和排序规则 零学习成本：直接基于行业标准 SemVer 2.0.0，无需额外知识 潜在缺点与局限性 被动参考性质：仅提供判断标准，无自动化检测或 CI/CD 集成能力 主观边界模糊："breaking change" 的判断依赖维护者经验，如"显著改变默认行为"缺乏量化标准 生态差异未覆盖：不同语言/工具对预发布标签的解析存在细微差异 无版本冲突解决：未涉及多依赖版本冲突时的 resolution 策略 适合人群 开源库维护者需要规范 release 流程 团队 Tech Lead 建立统一的版本管理规范 DevOps 工程师设计 CI/CD 版本自动升级策略 新手开发者快速理解 SemVer 语义 常规风险 误判风险：将 breaking change 标记为 MINOR 可能导致下游用户构建失败 版本膨胀：频繁 MAJOR bump 造成用户升级压力（语义化版本不限制 MAJOR 数字大小） 预发布误用：用户可能意外安装 x.x.x-alpha 到生产环境 安全评估说明 本工具为纯文档型知识参考，无代码执行、无外部依赖调用、无敏感数据访问，风险极低。 原始说明 Semantic Versioning 2.0.0 reference guide. Quick decision trees and examples for choosing MAJOR, MINOR, or PATCH version bumps.