撰写Git提交记录时，最让人纠结的莫过于在“写得粗糙被同事吐槽”和“花费十分钟精心润色”之间反复权衡。通义灵码恰好提供了一条高效路径——自动生成规范的commit message，省去手动组织语言的繁琐过程。下面将这套操作逐一拆解，每个环节都会指出常见误区，帮你少走弯路。

安装并启用通义灵码插件

打开VS Code，切换到左侧扩展面板，搜索“Tongyi Lingma”并进行安装。这一步完成后不要急于使用——必须点击“重新加载”让插件生效，否则右下角连通义灵码的图标都无法显示，Git提交时的AI辅助功能自然也无法触发。这算是整条链路的第一道硬性门槛，无法跳过。

在Git提交界面调出AI生成建议

代码修改完毕后，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入“Git: Commit”回车，提交输入框随即弹出。光标落在编辑区时，右下角会出现“? 用AI生成”按钮。点击该按钮，通义灵码会自动分析当前暂存区（staged）中修改了哪些文件，并给出三条不同风格的提交信息候选。

这里有一个容易被忽略的前提：AI只认可已经 git add 过的文件。如果你修改了代码但没有暂存，那么生成的内容会遗漏关键改动，导致commit message与实际变更不一致。因此提交前务必先确认暂存区已干净。

选择并微调AI生成的提交信息

得到三条候选项后，有三种处理方式：

最直接的方法是回车采纳第一条；如果想更换，按上下方向键切换，选中后回车确认即可。

但更推荐的做法是——生成后先别急着提交，手动微调一下。例如AI可能只写了“修复登录页样式错位”，你可以在冒号前补充“fix(login):”，变成“fix(login): 修复登录页表单按钮垂直居中错位”。这样类型前缀和作用域都补全了，符合Conventional Commits规范，团队CI检查也不会报错。

如果AI建议完全没有提及改动模块，比如只写了“更新了一些代码”，那就必须手动补充，否则团队成员看了完全不清楚改了什么内容。

提交前验证格式是否合规

按下Ctrl/Cmd+Enter之前，花三秒钟确认两个要点：

第一，提交框顶部显示的message是否包含了类型前缀（如 feat、fix、docs、test）和用括号包裹的作用域（如 (user)、(router)）。缺少的就立即补上。

第二，首行长度是否 ≤ 72 字符。超出部分会被Git截断显示，PR审查时可能漏掉关键信息。如果超长，要么压缩措辞，要么将详细信息放到正文第二行以后。

确认无误后，按下 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）执行提交，通义灵码会自动将最终文本同步到本地仓库。至此，一次规范的Git提交就顺利完成。