Claude Code 实战课

主题

2.4 Git 操作 — AI 帮你管理代码版本 ​

学习目标：学会用 AI 自动生成 commit message、创建 PR、做 Code Review、解决合并冲突，彻底告别 Git 操作焦虑。

为什么 Git 操作需要 AI 帮忙 ​

对很多开发者来说，Git 是每天必须用但永远用不顺手的工具。常见的痛点：

  • 写 commit message 纠结半天，最后写个 fix 了事
  • 创建 PR 时描述懒得写，reviewer 看不懂改了什么
  • Code Review 一大堆文件，看到眼花也不确定有没有遗漏
  • 遇到合并冲突就慌了，不知道该保留哪边

Claude Code 可以接管这些让你头疼的 Git 操作。它不只是帮你敲命令，而是真正理解你的代码改动，然后做出有意义的操作。

AI 自动写 Commit Message ​

这是你每天都会用到的功能。改完代码后，不要自己写 commit message，交给 AI。

方式一：用 /commit 技能（推荐） ​

bash
/commit

AI 会自动做三件事：

  1. 执行 git diff 分析你所有的改动
  2. 理解改动的业务含义
  3. 生成符合 Conventional Commits 规范的 commit message

[截图: /commit 技能的完整执行过程，从分析 diff 到生成 message 到确认提交]

示例输出：

feat(auth): implement JWT refresh token rotation

- Add refresh token endpoint with rotation logic
- Store token family for reuse detection
- Add 7-day expiry for refresh tokens
- Update auth middleware to handle token refresh

方式二：直接用自然语言 ​

帮我提交当前的修改，commit message 要描述清楚改了什么

AI 同样会分析 diff，然后生成 message 并执行提交。

[截图: AI 分析 diff 后生成的 commit message，显示改动摘要]

效率差距有多大？ ​

不用 AI：看 diff → 自己总结改了什么 → 想怎么写才规范 → 纠结措辞 → 写完提交。整个过程 2-5 分钟，遇到大改动可能更久。

用 AI：一条命令 → 3 秒生成 → 确认提交。而且 AI 不会偷懒写 fix bug，它会把每个文件的改动都分析到位。

AI 创建 PR ​

PR（Pull Request）是团队协作的核心环节。一个好的 PR 描述能帮 reviewer 快速理解你做了什么、为什么这么做。

帮我创建一个 PR，从 feature/user-auth 合并到 main

AI 会自动：

  1. 分析这个分支相对于 main 的所有改动（git diff main...HEAD）
  2. 按模块整理改动内容
  3. 生成结构化的 PR 描述
  4. 通过 GitHub CLI（gh）或 GitHub MCP 创建 PR

[截图: AI 生成的 PR 描述，包含 Summary、Changes、Testing 等结构化章节]

生成的 PR 描述通常包含：

markdown
## Summary
实现用户认证模块，包含注册、登录、Token 刷新功能。

## Changes
### New Files
- `src/auth/controller.ts` — 认证相关的 API 端点
- `src/auth/service.ts` — 认证业务逻辑
- `src/auth/middleware.ts` — JWT 验证中间件

### Modified Files
- `src/app.ts` — 注册认证路由
- `src/types/index.ts` — 添加 User 和 Token 类型

## Testing
- [ ] 注册接口：正常注册、重复邮箱、无效输入
- [ ] 登录接口：正常登录、错误密码、不存在用户
- [ ] Token 刷新：正常刷新、过期 Token、无效 Token

不用 AI：自己对比改动、手写描述，经常遗漏改动点，reviewer 需要自己去猜你做了什么。

用 AI：全自动生成，而且 AI 比你更不容易遗漏——它会逐文件分析每一行 diff。

AI Code Review ​

这可能是 AI 在 Git 工作流中最有价值的应用。

审查自己的代码 ​

提交 PR 之前，先让 AI 帮你审查一遍：

审查一下我这次的所有改动，重点看安全问题和逻辑错误

或者使用技能：

bash
/code-review

[截图: AI Code Review 的输出报告，按严重程度分类列出问题]

AI 会从多个维度审查你的代码：

Code Review Report
==================

❌ CRITICAL (1)
  src/auth/service.ts:34
  密码使用 MD5 哈希，强度不足。应使用 bcrypt 或 argon2。

⚠️ HIGH (2)
  src/auth/controller.ts:56
  登录失败时返回了 "用户不存在" 的具体信息，攻击者可利用此枚举用户。
  建议统一返回 "邮箱或密码错误"。

  src/auth/middleware.ts:12
  JWT 验证缺少 token 过期时间检查。

💡 MEDIUM (3)
  src/auth/service.ts:78 — 可提取公共的错误处理逻辑
  src/auth/controller.ts:23 — 入参校验缺少邮箱格式验证
  src/types/index.ts:15 — User 类型的 password 字段建议标记为 never 防止意外泄露

审查别人的 PR ​

如果你是 reviewer，也可以让 AI 帮你看别人的代码：

帮我审查 PR #42 的代码改动

AI 会拉取 PR 的 diff，给出专业的审查意见。你可以在此基础上做二次判断，大幅缩短 Review 时间。

[截图: AI 审查 PR 代码后输出的审查意见]

AI 解决合并冲突 ​

合并冲突是很多人的噩梦。看到一堆 <<<<<<< 和 >>>>>>> 标记就头大。

当你遇到合并冲突时，不要自己硬看，直接告诉 AI：

我 merge main 分支时出现了冲突，帮我解决

AI 会：

  1. 找到所有有冲突的文件
  2. 分析冲突双方的代码意图
  3. 给出合并建议，并解释为什么这样合并
  4. 征求你确认后执行修改

[截图: AI 解决合并冲突的过程，显示冲突内容和 AI 的合并建议]

一个真实场景：

你在 feature/auth 分支修改了 src/app.ts 的路由注册代码，同事在 main 分支也改了同一个文件的路由部分。合并时冲突了。

AI 的处理过程：

分析冲突文件: src/app.ts

你的分支 (feature/auth):
  添加了 /auth/login 和 /auth/register 路由

main 分支:
  添加了 /users/profile 路由并重构了路由注册方式

建议合并方案:
  保留 main 分支的路由注册重构（新的结构更好），
  同时将你的 auth 路由按照新的注册方式添加进去。

这样两边的改动都保留了，而且代码风格统一。

不用 AI：盯着冲突标记，对比两边代码，猜测应该保留哪边，经常改完还有 Bug。

用 AI：AI 理解双方代码的意图，给出有道理的合并方案。你只需要确认。

完整的 AI Git 工作流 ​

把以上四个能力串起来，就是一套完整的日常开发流程：

1. 写代码
   ↓
2. /code-review    ← AI 自审，修复问题
   ↓
3. /commit         ← AI 自动写 commit message
   ↓
4. 创建 PR         ← AI 自动写 PR 描述
   ↓
5. 合并时有冲突？   ← AI 帮你解决
   ↓
6. 合并完成 ✅

整个流程你只需要做两件事：写代码和点确认。其他全交给 AI。

效率对比 ​

Git 操作手动做AI 做
写 Commit Message2-5 分钟 / 次3 秒 / 次
写 PR 描述10-20 分钟30 秒
Code Review（中等 PR）30-60 分钟5 分钟（初筛）
解决合并冲突10-30 分钟，容易出错1-3 分钟，带解释
每天 Git 操作总耗时1-2 小时10-15 分钟

小结 ​

  • 用 /commit 自动生成规范的 commit message，永远告别 fix bug 和 update。
  • 创建 PR 时让 AI 自动分析全部改动，生成结构化的 PR 描述。
  • 提交前先让 AI 做 Code Review，它能找到你看不到的安全和逻辑问题。
  • 合并冲突不要硬看，让 AI 分析双方意图，给出合并建议。
  • 把这四步串成工作流：写代码 → 自审 → 提交 → 创建 PR → 合并。每天节省 1-2 小时。

用 Claude Code 构建，用 VitePress 驱动

© 2026 Claude Code 实战课