百度Comate连接Git仓库使用教程

要在百度Comate中完成代码编写后直接提交到Git仓库，必须先让Comate识别当前项目为有效的Git工作区，并使其能够调用底层Git命令或集成IDE的提交流程。如果项目尚未初始化Git、未关联远程仓库，或者Comate无法获取Git上下文，那么智能生成Commit Message和一键提交功能将不会出现。简而言之，关键步骤为：初始化本地Git仓库，并关联远程地址。

确认本地项目已初始化为Git仓库

检查Git状态

打开终端（或VS Code内置的Terminal），进入项目根目录，执行以下命令：

git status

如果系统提示“fatal: not a git repository”，说明项目尚未初始化。此时需要立即执行初始化操作。

初始化Git仓库

在项目根目录运行：

git init

这一步不可跳过——Comate所有与Git相关的功能，包括Commit生成、文件粒度分析、关联Issue，都依赖项目根目录下的.git文件夹。缺少该文件夹时，侧边栏的“Git”标签页会显示为空，按Ctrl+K弹出的提交窗口中也不会出现“ Generate with Comate”按钮。

关联远程Git仓库

创建并获取远程仓库地址

前往GitHub、Gitee等平台新建一个空仓库，复制其HTTPS或SSH地址。

添加远程仓库

回到终端，执行：

git remote add origin https://github.com/yourname/yourrepo.git

验证远程仓库连接

使用以下命令确认是否成功：

git remote -v

若输出类似 origin https://github.com/yourname/yourrepo.git (fetch) 的内容，则表示连接正常。注意：如果之前已添加过origin但URL有误，需先执行 git remote remove origin 再重新添加，否则Comate可能读取到无效地址，导致后续推送失败。

通过Comate侧边栏一键生成并提交

前置条件

确保VS Code中已安装Comate插件并登录百度账号，且当前打开的文件属于已初始化并关联远程仓库的项目。

生成Commit Message

点击VS Code左侧面板的Comate图标 → 切换到“Git”标签页 → 点击“Generate Commit”按钮。Comate会自动扫描暂存区（staging area）中的变更，分析新增的函数名、修改的组件以及检测到的Issue编号（如PR#123或fix #45），随后生成符合Conventional Commits规范的文案。例如：

feat(auth): add JWT token refresh logic in LoginService
fix(api): handle null response from /user/profile endpoint

提交并推送

生成文案后，文案会自动填入下方的Commit面板，您可手动微调。确认无误后点击“Commit and Push”——该操作会同时执行 git commit -m "xxx" 和 git push origin main（或当前所在分支）。

使用行间对话快速触发Commit生成

方法一：选中代码块触发

打开任意一个被修改的文件 → 选中本次改动的代码块（若不选择，则默认覆盖所有未提交变更）→ 按Ctrl+I（Windows/Linux）或Cmd+I（macOS）触发行间对话 → 输入“生成commit message”。

方法二：直接输入描述

不选中代码，在编辑器任意位置唤出行间对话 → 输入类似“写提交说明，本次改了用户头像上传和压缩逻辑”的指令 → Comate会结合当前文件路径、函数签名、git diff摘要生成精准描述。

务必检查生成文案是否包含测试路径、本地绝对路径或硬编码的密钥——Comate不会主动过滤此类敏感内容。

右键菜单按文件粒度生成Commit

选择文件

在VS Code资源管理器中，右键点击一个或多个未提交的文件（支持多选）。

生成结构化Message

选择“Comate: Generate Commit for Selected Files”。Comate会为每个文件单独分析变更意图，然后合并成一条结构化的Message，格式为“Summary + Body”双段式，Body中逐行列出各文件的关键改动点。例如：

refactor(storage): migrate image upload to new S3 client
- src/services/upload.ts: replace aws-sdk v2 with v3 S3Client
- src/utils/compress.ts: add WebP fallback when A VIF fails

该Message会直接复制到剪贴板，粘贴到IDE原生的Commit窗口中即可提交。