@Git 命令

引言

@Git 命令是 Cursor 中专门用于处理版本控制信息的上下文命令。它允许您在与 AI 助手对话时引用和分析 Git 历史记录、提交信息、分支信息等。这个功能特别适合需要理解代码变更历史、追踪 bug 引入时间、或进行代码审查的场景。

使用 @Git 命令分析代码变更历史，获取 AI 助手的深入见解。

基本用法

1. 查看提交历史

查看特定文件的提交历史。

@Git:log src/components/Button.tsx

2. 分析变更内容

分析两个提交之间的代码变更。

@Git:diff abc123 def456

3. 查看分支信息

查看特定分支的信息和状态。

@Git:branch feature/new-ui

高级功能

1. 代码归因

查看代码的作者和最后修改时间。

@Git:blame src/utils/api.ts:50-100

2. 提交搜索

搜索特定关键词的提交。

@Git:search "fix: memory leak"

3. 变更统计

统计代码变更情况。

@Git:stats --since="1 month ago"

常见使用场景

1. Bug 追踪

这个 bug 是什么时候引入的？

@Git:bisect src/components/DataGrid.tsx

通过分析提交历史，我发现：

Bug 在 3 周前引入
涉及性能优化的提交
影响了数据加载逻辑

2. 代码审查

请帮我审查这次提交的变更。

@Git:review HEAD

代码审查结果：

发现潜在的性能问题
建议添加错误处理
需要更新测试用例
代码风格符合规范

3. 功能追踪

这个功能是如何演进的？

@Git:history feature/user-auth

功能演进历程：

初始实现基本登录
添加社交媒体登录
增加双因素认证
优化错误处理

最佳实践

提交信息规范
使用清晰的提交信息，便于后续分析和追踪。
合理分支
使用合适的分支策略，保持代码历史清晰。
定期提交
保持适当的提交频率，避免过大的变更。
代码审查
及时进行代码审查，保证代码质量。

故障排除

问题：Git 仓库问题

解决方案：

检查 Git 仓库是否正确初始化
确认远程仓库连接状态
验证用户权限设置

问题：提交历史问题