Better-Commits项目中哈希标签预处理功能的优化解析

在Git提交信息中规范地引用问题跟踪编号是开发工作流中的重要实践。Better-Commits作为一款Git提交信息规范化工具，近期对其哈希标签预处理功能进行了重要优化，解决了手动输入问题编号时无法自动添加哈希标签的问题。

功能背景

问题跟踪系统通常采用不同的编号格式，例如GitHub使用纯数字加哈希标签（如#123），而Jira等系统则采用项目代码加数字的格式（如PROJ-123）。Better-Commits提供了prepend_hashtag配置项，用于控制在提交信息中如何显示问题编号。

原有实现的问题

在1.13.0版本之前，当用户从分支名无法推断出问题编号时（例如分支名为"my-feature-branch"），即使用户在交互式提示中手动输入了问题编号，配置中的append_hashtag选项也不会生效。这导致生成的提交信息中缺少预期的哈希标签前缀。

解决方案架构

开发团队经过深入讨论后，决定对功能进行以下改进：

1. 将配置项从append_hashtag更名为更准确的prepend_hashtag
2. 引入三级控制策略：
   • Always：始终添加哈希标签，无论编号来源
   • Prompt：仅在交互提示中根据用户输入决定
   • Never：从不添加哈希标签

技术实现细节

新版本中，预处理逻辑现在会检查以下条件：

1. 配置中prepend_hashtag的值
2. 问题编号的来源（自动推断或手动输入）
3. 问题编号的格式（纯数字或包含字母）

对于GitHub风格的纯数字编号，当配置为"Always"时，系统会无条件添加#前缀；而对于Jira等包含字母的编号，则保持原样输出。

最佳实践建议

1. 对于纯GitHub项目，建议设置prepend_hashtag: "Always"
2. 混合使用多种问题跟踪系统时，建议使用"Prompt"模式
3. 企业级Jira等系统项目可设为"Never"

升级注意事项

从旧版本升级时需要注意：

1. append_hashtag配置项已被标记为废弃
2. 原有true/false值会自动映射为"Always"/"Never"
3. 建议检查历史提交信息格式是否符合预期

这一改进使得Better-Commits在处理各种问题跟踪系统时更加灵活和可靠，为团队提供了一致的Git提交信息规范体验。