编写 Git 提交消息这件事，说实在的，经常让人感到头疼——尤其是当你刚修改完一堆代码，思维还沉浸在业务逻辑里，却需要纠结用 feat 还是 fix、是否添加作用域、有没有遗漏关键变更点。CodeGeeX 帮你彻底解决了这个痛点：它基于暂存区中的 git 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 时，可以避免笼统的描述，让提交历史更加干净清晰。