写提交说明（Commit Message）是开发中最容易敷衍的环节，却直接影响后期代码追溯和 Code Review 的效率。Cursor 支持基于当前暂存区（Staged Changes）的 Diff 内容，一键生成结构化的提交说明，省去手动总结的繁琐。
触发方式
确保项目已初始化 Git 仓库，且当前有文件处于已暂存状态。打开左侧活动栏的 源代码管理（Source Control） 面板（图标为分支符号），在顶部的提交信息输入框右侧，你会看到一个 生成提交说明 的图标（通常显示为星星或魔法棒形状）。点击该图标，Cursor 便会自动读取暂存区的代码差异，调用 AI 生成提交说明并直接填入输入框。
生成效果与格式
默认输出通常遵循 Conventional Commits 规范，例如：
feat(auth): add JWT token refresh mechanism
- implement refresh endpoint in auth controller
- update middleware to verify token expiry对于改动较杂的提交，AI 会自动提炼标题与要点列表；若是简单单行修复，则输出简洁的 fix: 或 refactor: 标题。
自定义团队规范
如果团队对提交说明有固定格式（如必须带 Jira 单号、要求中文描述等），可直接在侧边栏对话中追加要求，例如：“按【类型】模块-简述 的格式，用中文总结当前 staged changes”。AI 会依据你的规则重新输出，你复制填入即可。部分版本也支持在设置中预设提交说明的自定义提示词模板。
实用提示
- 必须先暂存文件：Cursor 只分析 Staged Changes，未暂存的改动不会被纳入。若生成后发现遗漏，补
git add后重新点击生成即可。 - 大 Diff 建议分批：若一次暂存了上千行跨文件改动，生成的说明容易过于笼统。建议按功能模块分批次暂存并分别生成，让每条提交更精准。
- 养成二次校对习惯：AI 偶尔会在类型判断上出错（例如把
fix写成feat），提交前快速扫一眼标题和范围（scope），确认无误后再按Ctrl+Enter提交。
这个功能不仅省时间，还能在提交前帮你快速回顾本次改动的全貌，相当于一次微型的自我 Code Review。