Git 集成

Claude Code 与 Git 深度集成，可以帮助你管理版本控制工作流。从创建提交到管理分支，Claude 可以自动化许多 Git 操作，同时遵循最佳实践。

Git 工作流基础

查看状态

Claude 可以帮助你理解当前的 Git 状态：

检查 git 状态，告诉我有哪些更改

Claude 会运行 git status 并解释结果，包括：

• 已修改的文件
• 暂存的更改
• 未跟踪的文件
• 当前分支信息

查看差异

显示我对 src/auth/login.ts 的更改

Claude 会运行 git diff 并解释更改的内容和影响。

创建提交

智能提交消息

Claude 可以分析你的更改并生成有意义的提交消息：

为当前更改创建一个提交

Claude 会：

1. 检查所有更改的文件
2. 分析更改的性质
3. 生成符合约定式提交规范的消息
4. 创建提交

示例提交消息：

feat(auth): add JWT refresh token support

- Implement token refresh endpoint
- Add refresh token to user session
- Update authentication middleware

遵循提交规范

Claude 理解常见的提交消息规范：

• Conventional Commits
• Angular 提交规范
• Semantic Commit Messages

你可以指定项目使用的规范：

使用 Angular 提交规范创建提交

分阶段提交

对于包含多个逻辑更改的工作，分阶段提交：

将认证相关的更改创建一个提交，
UI 更改创建另一个提交

Claude 会：

1. 识别不同类型的更改
2. 分别暂存相关文件
3. 为每组更改创建独立的提交

分支管理

创建分支

创建一个新分支 feature/user-profile

Claude 会：

• 检查当前分支状态
• 创建新分支
• 切换到新分支
• 确认操作成功

分支命名规范

Claude 可以帮助遵循分支命名规范：

为添加邮件通知功能创建一个分支

Claude 会根据常见规范建议名称：

• feature/email-notifications
• feat/email-notifications
• add-email-notifications

切换分支

切换到 main 分支

Claude 会：

• 检查是否有未提交的更改
• 如有必要，提示保存或暂存更改
• 切换分支
• 确认切换成功

合并分支

将 feature/user-profile 合并到 main

Claude 会：

1. 切换到目标分支
2. 检查是否有冲突
3. 执行合并
4. 如有冲突，提供解决建议

处理合并冲突

识别冲突

检查合并冲突

Claude 会列出所有有冲突的文件，并解释冲突的性质。

解决冲突

帮我解决 src/config.ts 中的合并冲突

Claude 会：

1. 显示冲突的内容
2. 分析两个版本的差异
3. 建议解决方案
4. 应用解决方案
5. 标记冲突已解决

复杂冲突处理

对于复杂的冲突：

这个冲突涉及重构和新功能，
保留新功能但采用重构后的结构

Claude 会理解你的意图并智能合并代码。

代码审查工作流

创建 Pull Request

为当前分支创建 PR

Claude 会：

1. 推送当前分支到远程
2. 分析提交历史
3. 生成 PR 标题和描述
4. 使用 GitHub CLI 创建 PR

PR 描述生成

Claude 生成的 PR 描述通常包含：

## 更改内容
- 添加用户个人资料页面
- 实现头像上传功能
- 添加个人信息编辑表单

## 测试
- 单元测试覆盖率 95%
- 手动测试所有表单验证
- 测试文件上传限制

## 截图
[如适用]

## 相关 Issue
Closes #123

审查他人的 PR

审查 PR #456

Claude 会：

1. 获取 PR 的更改
2. 分析代码质量
3. 检查潜在问题
4. 提供改进建议
5. 生成审查评论

历史管理

查看提交历史

显示最近 10 次提交

查看 src/auth/ 目录的提交历史

查找特定更改

找出是哪次提交引入了 User 接口

Claude 会使用 git log 和 git blame 来追踪更改。

回退更改

回退最后一次提交但保留更改

Claude 会使用 git reset --soft HEAD~1。

完全撤销最后一次提交

Claude 会使用 git reset --hard HEAD~1（会先确认）。

Stash 管理

保存工作进度

暂存当前更改，我需要切换分支

Claude 会：

• 运行 git stash push
• 添加描述性消息
• 确认暂存成功

恢复工作进度

恢复我之前暂存的更改

Claude 会：

• 列出可用的 stash
• 应用最近的 stash
• 处理可能的冲突

管理多个 Stash

列出所有 stash

应用 stash@{2}

远程仓库操作

推送更改

推送当前分支到远程

Claude 会：

• 检查远程分支状态
• 推送更改
• 处理可能的冲突
• 确认推送成功

拉取更新

从 main 分支拉取最新更改

Claude 会：

• 运行 git pull
• 处理合并冲突（如有）
• 更新本地分支

同步 Fork

同步我的 fork 与上游仓库

Claude 会：

1. 添加上游远程（如未添加）
2. 获取上游更改
3. 合并到本地分支
4. 推送到你的 fork

Git 最佳实践

原子提交

Claude 鼓励创建原子提交：

这些更改应该分成几个提交？

Claude 会分析更改并建议逻辑分组。

提交前检查

在创建提交前，Claude 会：

• 运行 linter
• 运行测试
• 检查代码格式
• 验证构建成功

保护敏感信息

Claude 会检测并警告：

警告：.env 文件包含敏感信息，不应提交。
已将其添加到 .gitignore。

高级 Git 操作

交互式 Rebase

清理最近 5 次提交的历史

Claude 会帮助你：

• 合并相关提交
• 重写提交消息
• 重新排序提交
• 删除不必要的提交

Cherry-pick

将提交 abc123 应用到当前分支

Claude 会：

• 执行 cherry-pick
• 处理冲突
• 验证结果

子模块管理

添加子模块 https://github.com/user/repo

更新所有子模块

Git Hooks 集成

Pre-commit Hooks

Claude 可以帮助设置 pre-commit hooks：

设置 pre-commit hook 来运行 linter 和测试

Commit Message Validation

添加 commit-msg hook 来验证提交消息格式

故障排除

解决 Detached HEAD

我处于 detached HEAD 状态，怎么办？

Claude 会：

1. 解释当前状态
2. 提供恢复选项
3. 帮助创建新分支或返回原分支

恢复丢失的提交

我不小心删除了一个分支，如何恢复？

Claude 会使用 git reflog 来找回丢失的提交。

清理仓库

清理未跟踪的文件和目录

Claude 会：

• 先显示将被删除的内容
• 确认后执行清理
• 使用 git clean

团队协作模式

Git Flow

使用 Git Flow 创建一个新功能分支

Claude 理解 Git Flow 模式并会：

• 从 develop 创建 feature 分支
• 遵循命名规范
• 在完成时合并回 develop

GitHub Flow

使用 GitHub Flow 开始新功能

Claude 会：

• 从 main 创建分支
• 开发完成后创建 PR
• 合并后删除分支

Trunk-Based Development

使用 trunk-based 模式提交更改

Claude 会：

• 创建短期分支
• 快速合并到 main
• 使用 feature flags 控制功能

性能优化

大型仓库处理

对于大型仓库，Claude 会：

• 使用浅克隆
• 启用稀疏检出
• 优化 Git 配置

清理历史

减小仓库大小

Claude 会：

• 识别大文件
• 使用 git-filter-repo 清理历史
• 重写历史（需确认）

最佳实践清单

• [ ] 提交前运行测试
• [ ] 使用描述性的提交消息
• [ ] 保持提交的原子性
• [ ] 定期推送到远程
• [ ] 及时解决合并冲突
• [ ] 不提交敏感信息
• [ ] 使用分支进行功能开发
• [ ] 代码审查后再合并
• [ ] 保持提交历史清晰
• [ ] 定期同步远程更改

通过 Claude Code 的 Git 集成，你可以更高效地管理版本控制，专注于编写代码而不是记忆 Git 命令。