清晰的提交信息由类型、标题、正文和脚注组成,推荐遵循Conventional Commits规范;VS Code支持多行输入与GitLens插件,可提升编写与查看效率;应避免模糊描述、超长单行及遗漏issue关联。

写好 Git 提交信息是代码协作中非常重要的一环。清晰的提交信息能帮助团队快速理解每次变更的目的和范围,尤其在排查问题或回顾历史时非常有用。VS Code 提供了良好的 Git 集成,结合规范格式,可以高效写出高质量的提交信息。
使用清晰的提交信息结构
一个有效的提交信息通常由三部分组成:类型、标题和可选的正文与脚注。推荐采用 Conventional Commits 规范,格式如下:
- 类型:如 feat、fix、docs、style、refactor、test、chore 等,说明变更性质
- 标题:简明扼要地描述做了什么,用动词开头,例如 "fix login validation error"
- 正文(可选):详细说明为什么改、怎么改,以及相关背景
- 脚注(可选):关联 issue 编号,如 "Closes #123"
feat: add user profile page
Add new route and component for user profile display.
Closes #45
在 VS Code 中优化提交体验
VS Code 的源代码管理面板支持多行输入,点击“消息”输入框即可展开。利用这个功能写完整结构的信息,而不是只写一行。
- 点击源码管理侧边栏中的 “...” 菜单,选择 “Commit with Input” 可打开编辑区域
- 使用 GitLens 插件增强提交信息展示,查看每行代码的作者与提交记录
- 启用拼写检查,避免低级错误影响专业性
避免常见错误
糟糕的提交信息会降低项目维护效率。注意避开以下问题:
- 信息过短,如 "update file" 或 "fix bug",缺乏上下文
- 使用模糊动词,如 "changed"、"modified",应改为具体动作如 "rename variable" 或 "add validation"
- 一行写太长,超过 72 个字符建议换行
- 忘记关联 issue 或 PR,导致追踪困难
养成良好习惯
提交前花一分钟思考这次修改的核心目的。可以在 VS Code 中先写好提交信息再确认提交,避免草率操作。
- 把提交信息当作写给未来的自己或同事的一条说明
- 配合
.gitmessage模板统一格式,提高一致性 - 使用快捷键 Ctrl+Enter 提交(确保光标在消息区)
基本上就这些。写清楚提交信息不复杂但容易忽略,坚持下来会让整个项目的 Git 历史更清晰可信。










