在团队协作中，规范的 Git Commit 信息是提升沟通效率、代码可维护性和自动化流程的关键。以下基于行业广泛采用的 Conventional Commits 规范（如 Angular 风格）[citation:1][citation:4][citation:5]，结合实践建议，为你提供清晰的填写指南：

🧱 一、Commit 信息的核心结构（必含类型）

规范的 Commit 信息通常分为三部分，通过空行分隔：

<类型>(<作用域>): <主题>  // Header（必需）
<空行>
<详细描述>              // Body（可选）
<空行>
<页脚信息>              // Footer（可选）

1. Header（头部）：简洁说明修改性质

  • 类型（Type）：必填，明确修改的类别，常用类型包括[citation:1][citation:4][citation:8]：
    | 类型 | 适用场景 | 是否进 Changelog | |------------|------------------------------------------|---------------------| | feat | 新增功能（feature） | ✅ | | fix | 修复 Bug | ✅ | | docs | 文档更新（README、注释等） | ⚠️ 可选 | | style | 代码格式调整（空格、分号等，不影响逻辑） | ❌ | | refactor | 代码重构（非功能新增或 Bug 修复） | ❌ | | perf | 性能优化 | ✅ | | test | 测试用例新增或修改 | ❌ | | chore | 构建/工具/依赖变更（CI、包管理等） | ❌ | | revert | 回滚某次提交 | ✅ |
  • 作用域（Scope）：可选，说明影响范围（如模块、文件、功能）
    • 例：fix(auth):、feat(router):，无明确范围可用 *（如 chore(*):）[citation:4][citation:5]。
  • 主题（Subject）：必填，动词开头的简短描述（≤50字符）
    • 要求：使用现在时祈使语气（如 "add" 而非 "added"）、首字母小写、无句号[citation:1][citation:3]。

2. Body（正文）：详细解释修改内容（可选）

  • 说明 修改动机、技术细节或前后对比；
  • 每行 ≤72 字符，分段清晰[citation:1][citation:4]；
  • 示例：

    重构用户验证逻辑，减少冗余代码：

    • 移除重复的权限检查函数；
    • 合并身份验证中间件。

3. Footer（页脚）：关联问题或破坏性变更（可选）

  • 关闭 Issue：Closes #123 [citation:1][citation:5]；
  • 破坏性变更（Breaking Change）：
    • 以 BREAKING CHANGE: 开头，说明兼容性变化及迁移方案[citation:4][citation:7]；
    • 或通过在类型后加 ! 标识（如 feat!:）[citation:7]。

⚙️ 二、团队协作最佳实践

  1. 原子性提交
    一次提交只解决一个问题，避免混合功能、修复或重构，便于回滚和审查[citation:5][citation:10]。
  2. 关联任务追踪
    在主题或页脚中引用任务 ID（如 JIRA-123），自动化同步进度[citation:3][citation:6]。
  3. 分支与提交协同
    • 功能开发使用 feat/xxx 分支，修复使用 fix/xxx 分支；
    • 合并前通过 Pull Request（PR） 进行代码审查[citation:9][citation:10]。
  4. 自动化工具支持
    • 用 commitlint 校验信息格式；
    • 用 standard-version 根据类型自动生成 Changelog[citation:4][citation:5]。

📝 三、示例模板

feat(user): 新增头像上传功能
- 支持本地文件上传及URL导入；
- 添加头像裁剪组件。
BREAKING CHANGE: 移除旧版头像API，改用 `/v2/profile/avatar`。
Closes #45

fix(login): 解决Safari浏览器登录重定向循环
修复因会话Cookie处理不当导致的无限重定向问题，参考MDN安全配置建议。
Fixes #89

💎 四、总结：提升协作效率的关键点

  1. 类型标准化：用 feat/fix 等明确意图，避免模糊词汇（如 "update"）[citation:2][citation:5]；
  2. 作用域清晰化：限定影响范围，降低理解成本；
  3. 主题简洁有力：≤50字符的动词短语概括核心改动；
  4. 自动化兼容：通过规范格式实现 Changelog 自动生成、Issue 自动关闭[citation:1][citation:4]。

规范 Commit 信息不仅是格式要求，更是团队协作的契约。通过统一语言和结构，开发者能快速定位变更背景、减少沟通摩擦，并为自动化流程铺平道路[citation:6][citation:10]。