codebuddy提供三种规范git提交信息生成方式:ide内一键触发、终端命令直出、git钩子强制校验。vs code/jetbrains插件中点击【ai commit】按钮自动生成conventional commits格式文案;cli工具支持codebuddy generate-commit生成或ai-commit一键提交;husky+commitlint实现提交前自动拦截不合规文案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在写完代码后立刻生成一条规范、准确、能被团队和自动化工具识别的 Git 提交信息,而不是对着空输入框发呆或凭记忆硬凑格式。CodeBuddy 提供了三种可落地的提交文案生成路径:IDE 内一键触发、终端命令直出、Git 钩子强制校验联动。每种方式适配不同工作流,不依赖人工记忆 Conventional Commits 规则。
VS Code / JetBrains 插件中一键生成 Commit 文案
这是日常开发中最顺手的方式,适合单次小批量提交,所有操作都在编辑器内完成,无需切屏或记命令。
第一步:确保已安装最新版【腾讯云代码助手】插件,并完成微信扫码登录。
第二步:在 IDE 的 Git 面板中,确认你要提交的文件已处于“已暂存(Staged)”状态——如果还是灰色未暂存,右键文件→“Git: Stage Changes”或按 Ctrl+Shift+P → 输入 “Git: Stage All Changes” 执行。
第三步:点击 Git 提交消息输入框右侧的【AI COMMIT】按钮,不要手动输入任何内容。
第四步:等待 3–5 秒,输入框自动填充类似 feat(user): 添加邮箱格式校验逻辑 的文案,含 type、scope 和 subject 三要素。这一步不能跳过等待,模型需读取 diff 内容才能生成,强行提前提交会得到空白或泛泛而谈的文案。
第五步:可直接按 Ctrl+Enter(Windows/Linux)或 Cmd+Enter(macOS)提交;如需微调,编辑后再提交即可。
命令行下用 codebuddy generate-commit 生成并提交
适用于服务器环境、CI/CD 流水线集成、或你习惯纯键盘操作的场景。它不依赖 GUI,输出即用,且支持一键连提交。
方法一:先生成再手动提交
确保已全局安装 CLI 工具:npm install -g @tencent-ai/codebuddy-cli。
执行 codebuddy login 完成授权(支持微信扫码或 GitHub 登录)。
运行 git add . 或指定文件暂存变更。
输入 codebuddy generate-commit,终端立即输出标准格式文案,例如:fix(api): 修复用户查询接口返回空数组时未设 Content-Type 头。
复制该行,粘贴进 git commit -m "粘贴内容" 执行提交。
方法二:一键生成并提交(推荐)
暂存文件后,直接运行 codebuddy ai-commit。
该命令自动调用 generate-commit → 获取结果 → 调用 git commit -m 完成提交,全程无交互。
注意:此命令不会跳过 git hook,若已配置 commitlint,仍会触发校验。
用 Husky + commitlint 实现提交前自动拦截不合规文案
当团队多人协作时,仅靠自觉无法保证每条 commit 都符合规范。这个方案让 Git 自己把关,在本地提交瞬间就拒绝错误格式,避免后续修复成本。
1、在项目根目录运行:npm install --save-dev @commitlint/cli @commitlint/config-conventional。
2、创建 commitlint.config.js 文件,内容仅一行:module.exports = { extends: ['@commitlint/config-conventional'] };
3、初始化 Husky:npx husky install。
4、绑定钩子:npx husky add .husky/commit-msg 'npx --no-install commitlint --edit "$1"'。
5、现在每次执行 git commit -m "xxx" 或通过 IDE 提交时,只要文案不满足 type(scope): subject 结构(比如写成“修改了登录页”或漏掉冒号),就会中断并提示错误,强制你修正后再提交。











