规范化Commit Message可提升团队协作与代码可读性。1. 创建.gitmessage.txt模板文件定义格式;2. 通过git config commit.template配置路径;3. 推荐采用Conventional Commits规范:类型(作用域): 描述;4. 在VS Code中结合插件、代码片段和commitlint+husky实现自动校验,确保提交一致性,最终便于生成changelog与版本管理。

在 VS Code 中使用 Git 提交时,编写规范化的 Commit Message 能提升团队协作效率、增强代码历史可读性,并为后续的版本管理和自动化工具(如生成 changelog)提供支持。通过配置提交模板和遵循约定格式,可以让每次提交更清晰、一致。
为什么需要 Commit Message 模板?
没有规范的提交信息容易导致:
- 信息模糊,如“修复问题”或“更新代码”,难以理解具体变更
- 历史记录混乱,不利于排查问题或回溯变更
- 无法自动生成 changelog 或进行语义化版本控制
设定模板能引导开发者填写结构化内容,提高信息质量。
设置 VS Code 中的 Git 提交模板
1. 创建模板文件
在项目根目录或用户目录下创建一个文本文件,例如 .gitmessage.txt:
# 类型(作用域): 简短描述 # # * feat: 新功能 # * fix: 修复缺陷 # * docs: 文档变更 # * style: 代码格式调整(不影响逻辑) # * refactor: 重构(非新增功能或修复 bug) # * test: 添加或修改测试 # * chore: 构建流程或辅助工具变动type(scope): subject
Body of commit message (optional)
- 添加详细说明(可选)
- 列出关键变更点
- 关联 issue: #123
2. 配置 Git 使用该模板
在终端中运行以下命令(替换为你的模板路径):
git config commit.template ~/.gitmessage.txt
也可以针对当前项目单独设置:
git config --local commit.template .gitmessage.txt
配置完成后,每次在 VS Code 中打开提交输入框时,模板不会直接显示,但可通过其他方式辅助输入(见下文)。
推荐的 Commit Message 格式:Conventional Commits
采用 Conventional Commits 规范是一种广泛接受的做法。基本结构为:
类型(可选范围): 描述
常见类型包括:
- feat(api): 添加用户登录接口 —— 新增功能
- fix(ui): 修复按钮点击无效问题 —— 修复 bug
- refactor(auth): 优化登录状态管理逻辑 —— 重构代码
- docs: 更新 README 安装说明 —— 文档更新
主体部分可补充细节,比如动机、影响范围;页脚可标注打破性变更或关联任务编号。
在 VS Code 中提升提交体验
虽然 VS Code 不直接预览模板内容,但可以通过以下方式增强输入体验:
- 安装插件:如 "Git Commit Template" 或 "Better Commit Policy",可自动填充建议格式
- 使用快捷键 + 片段:自定义用户代码片段(Snippets),快速插入标准格式
-
结合提交前检查:使用
commitlint和husky验证提交信息是否符合规范
例如,在项目中添加 commitlint 配置后,不符合格式的提交将被拒绝,确保一致性。
基本上就这些。规范化提交不是为了增加负担,而是让每一次变更都更有意义。从设置一个简单的模板开始,逐步养成好习惯,你会发现代码历史变得更清晰、更可靠。










