通义灵码需要在登录并显示“已就绪”状态后，才能正常使用。右键调用它生成 Commit 信息时，必须借助前缀或自然语言来约束输出格式，确保符合 type(scope): subject 的结构。最后人工核查三要素——type 是否合法、scope 是否准确、subject 是否规范——再提交，才算完成完整闭环。

利用通义灵码自动生成符合 Angular 规范的 Git Commit 信息，关键步骤有两个：先让模型理解当前代码的具体改动，再强制约束输出格式为 type(scope): subject，否则它很容易自由发挥，导致格式混乱。

安装并启用通义灵码插件

在 VS Code 扩展市场搜索“Tongyi Lingma”→ 点击安装 → 安装完成后点击右下角的“登录”图标，使用阿里云账号授权。若未登录，代码补全和 commit 生成功能均不可用。务必完成登录并确保显示“已就绪”状态，才能进入下一步操作。

在 Git 提交面板中触发灵码生成

代码修改完成后，打开 VS Code 左侧活动栏的“源代码管理”图标 → 在“消息”输入框中右键 → 选择“使用通义灵码生成提交信息”。操作非常简便，只需右键一下。如果右键菜单中没有出现该选项，请检查插件是否已启用，以及当前工作区是否已初始化 Git 仓库（目录下需存在 .git 文件夹）。

手动引导生成符合规范的 Commit 内容

通义灵码默认生成的提交信息较为口语化，与 Conventional Commits 标准存在较大差异。因此，在提交框中应先输入提示词，再按下 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）唤出补全：

方法一：固定前缀引导
在提交框中输入“feat(api):”后立即按下 Ctrl+Enter，灵码会顺着这个前缀继续生成具体描述，例如“feat(api): 添加用户登录接口的 token 刷新逻辑”。

方法二：自然语言加约束条件
输入“请生成一条符合 Angular Commit 规范的提交信息，本次修改了 utils/date.ts 中的 formatDuration 函数，修复了毫秒转时分秒时分钟位缺失前导零的问题”→ 按下 Ctrl+Enter，模型将输出“fix(utils): 修复 formatDuration 分钟位缺少前导零”。

注意：如果只写“修复 date 工具函数”这类模糊描述，灵码可能忽略 scope 或使用不标准的 type（例如用“update”而非“fix”）。scope 必须来自实际修改的文件路径或模块名，不能虚构。

验证并提交

第一步：检查生成内容是否为三段式结构——type(可选 scope): subject
第二步：确认 type 属于约定值（feat、fix、docs、style、refactor、test、chore）之一
第三步：subject 首字母小写、不加句号、长度控制在 50 字符以内
第四步：点击“✓”按钮完成提交

这一步千万不能跳过校验。通义灵码不会自动拦截非法 type 或超长 subject，错误提交一旦推送至远程仓库，就会污染提交历史。