高效Git Commit Message：VS Code CodeGeex编写技巧

编写 Git 提交消息这件事，常常让人头疼——尤其在刚完成代码修改、思路还沉浸在业务逻辑中时，却要纠结使用 feat 还是 fix、是否添加作用域、有没有遗漏关键变更点。CodeGeeX 直接化解了这个痛点：它基于暂存区的 diff 自动生成符合 Conventional Commits 规范的一行式提交信息，省去反复斟酌和格式校验的耗时。安装插件、暂存文件后，点击 Git 面板上的闪电图标，就能看到多条候选信息，还支持预设模板、作用域检测，甚至能为单个文件精准生成。

安装与启用 CodeGeeX 插件

打开 VS Code 扩展市场（快捷键 Ctrl+Shift+X），搜索 【CodeGeeX 智能编程助手】，点击安装并重启编辑器。有个常见陷阱：插件必须全局启用，否则 Git 面板里不会出现那个闪电图标。另外，VS Code 版本需 ≥ 1.68.0，低版本无法加载核心功能。

在源代码管理面板一键生成提交信息

代码修改完成后，先将文件 【暂存（Stage）】：在源代码管理视图（Ctrl+Shift+G）中勾选变更文件左侧的复选框，或右键选择“暂存更改”。注意，只有暂存的文件才会被分析，未暂存的部分不会纳入。

接着，点击提交消息输入框上方的闪电图标（即 CodeGeeX 图标），插件立即读取 git diff 内容，然后弹出建议消息。结果以下拉列表形式展示，通常包含 3～5 条不同风格的选项，例如：feat(api): add retry logic for 429 responses、fix(auth): prevent token refresh on expired session。选中最贴切的一条，按 Enter 确认即可插入。

如果对第一条不满意，点击“重新生成”按钮，插件会基于同一 diff 再次采样，可能产出更侧重影响范围或修复深度的表述——相当于切换角度帮你总结。

自定义生成风格与作用域

想更贴合项目习惯？进入 VS Code 设置（Ctrl+,），搜索 【codegeex.commit】，找到 CodeGeeX: Commit Message Style 选项。

方法一：选择预设模板
可选 “Conventional Commits”（默认）、“Angular”、“Atom” 等，不同模板在前缀粒度、作用域括号格式、冒号后空格规则上有细微差异。例如，Angular 风格要求类型后加括号作用域，Atom 则更为简洁。

方法二：手动注入作用域
在设置中启用 CodeGeeX: Enable Scope Detection，插件会扫描当前修改涉及的文件路径，自动提取作用域。举例：如果你改了 src/components/Button.tsx，它会自动提取 scope 为 components，生成类似 chore(components): update storybook args interface 的消息。

需要留意：作用域检测依赖文件路径结构。若项目采用扁平化目录（比如所有组件都放在 src/ 下，无子目录），该功能可能返回空 scope，无法识别。

通过右键菜单为单个文件生成精准消息

有时一个文件里修改了多处逻辑，但只想为其中一项改动写 message，怎么办？CodeGeeX 支持单文件精准生成。

第一步：在源代码管理视图的 Local Changes 列表中，右键点击某个已暂存的文件（注意是文件，不是文件夹）。
第二步：从上下文菜单中选择 【CodeGeeX → Generate Commit Message】。
第三步：插件只会分析这一个文件的 diff，输出高度聚焦的描述。比如你改了 utils/date.ts 中的时区处理逻辑，它可能生成 fix(utils): correct DST offset calculation in parseLocalDate。

这个功能特别适合重构类提交——当一个文件承担多个职责，但你只想为其中一项改动写 message 时，就能避免泛泛而谈，让提交历史更干净清晰。