Git使用经验总结9-Git提交关联到Issue

1. 问题

GitHub、GitLab 等平台支持通过提交信息中的特定关键词自动关闭 Issue，例如关闭掉 Issue #789：

git commit -m "Fix typo. Fixes #789"

更具体一点，在 GitHub 中，以下关键词会自动关闭关联的 Issue：

• close, closes, closed
• fix, fixes, fixed
• resolve, resolves, resolved

但是如果只是想关联或提及某个 Issue，而不希望它被自动关闭，可以仅提及 Issue 编号。例如：

git commit -m "Add user login validation. Related to #123"

这样，提交会链接到 Issue #123，并在该 Issue 的时间线中显示此提交，但不会关闭它。

2. Issue

GitHub、GitLab 等基于 Git 的代码托管平台所提供了一套 Issue 跟踪系统（Issue Tracking System），可以用来协作管理项目中的“事项”。把 Issue 理解为一个任务卡片或问题工单，可以用来：

1. 报告 Bug（缺陷）。例如用户或开发者发现程序有问题，可以开一个 Issue 描述：出现什么错误？如何复现？期望 vs 实际行为？
2. 提出新功能。希望项目增加某个功能？开个 Issue 讨论可行性。
3. 跟踪任务进度。团队可以用 Issue 拆分开发任务，分配给成员，设置标签、里程碑、截止日期等。
4. 讨论设计或技术方案。在写代码前，先开 Issue 讨论架构、API 设计、依赖选型等，避免返工。
5. 文档改进、依赖更新、CI 配置等杂项。任何需要“被记录和完成”的事情，都可以是一个 Issue。

3. 钩子

Git提交关联到 Issue 是 GitHub 等代码托管平台的自带功能。如果要实现在代码提交后进行更加复杂的操作，那么可以使用 Git 钩子（Git Hooks）。Git 钩子是 Git 提供的一套事件回调机制，允许你在 Git 操作的特定阶段（如提交前、推送后等）自动执行自定义脚本。例如：

• 提交代码后自动发邮件通知团队
• 推送代码到服务器后自动部署
• 提交前检查代码格式或运行测试（不通过则阻止提交）
• 记录每次提交的日志到外部系统

这项技术在代码管理中非常有用，有时间再进行进一步研究。