1. 为什么我们需要记录Git问题作为一个开发者我每天都要和Git打交道。但说实话Git这个工具就像个脾气古怪的老朋友——你用得越久越会发现它时不时会给你一些惊喜。我清楚地记得上周五下午5点半当我正准备提交代码下班时Git突然报出一堆莫名其妙的冲突错误让我不得不留下来加班到晚上9点。这就是为什么我开始养成记录Git问题的习惯。每次遇到问题我都会详细记录下错误现象、解决过程和最终方案。这个习惯不仅帮我节省了大量重复解决问题的时间还让我逐渐摸清了Git的脾气。现在我想把这些经验分享给你。2. Git安装与配置的常见陷阱2.1 选择正确的安装方式很多人觉得Git安装很简单直接去官网下载安装包就行。但实际上不同操作系统下的安装方式有很大差异Windows系统建议使用Git for Windows原msysGit它包含了Git Bash这个强大的命令行工具Mac系统推荐通过Homebrew安装brew install git比直接下载pkg更灵活Linux系统使用系统包管理器如apt-get install git或yum install git我曾经在Ubuntu上直接用apt-get安装Git结果发现版本太旧1.8.x很多新功能无法使用。后来改用PPA源才解决了这个问题sudo add-apt-repository ppa:git-core/ppa sudo apt-get update sudo apt-get install git2.2 初始配置的注意事项安装完Git后有三项基础配置必不可少git config --global user.name 你的名字 git config --global user.email 你的邮箱 git config --global core.editor vim # 可以换成你喜欢的编辑器这里有个容易踩的坑邮箱地址一定要和你代码托管平台如GitHub、GitLab的账号邮箱一致否则提交记录无法正确关联到你的账号。我曾经因为公司邮箱和个人GitHub邮箱不一致导致贡献统计出现偏差。提示使用git config --list可以查看当前所有配置项git config --global --unset可以删除不需要的配置。3. 日常使用中的高频问题解决方案3.1 提交(commit)相关错误问题1提交了错误的文件# 添加文件到暂存区后想取消 git reset HEAD 文件名 # 已经提交了但还没push git reset --soft HEAD~1 # 保留修改 git reset --hard HEAD~1 # 丢弃修改问题2提交信息写错了git commit --amend # 修改最后一次提交信息我有个同事曾经在提交信息里写了老板是傻X幸好及时发现用amend修改了否则push上去就尴尬了。3.2 分支(branch)管理难题场景需要基于某个旧提交创建分支# 先找到那个提交的hash git log --oneline # 然后基于它创建分支 git checkout -b 新分支名 提交hash场景不小心删除了本地分支# 先查看所有分支包括已删除的 git reflog # 找到删除前的commit hash git checkout -b 分支名 对应的hash上周我不小心删除了一个开发了两天的功能分支就是靠reflog找回来的。那一刻真的体会到了Git的强大。3.3 合并(merge)与变基(rebase)冲突合并冲突是Git新手最头疼的问题。我的经验是先确保工作区是干净的没有未提交的修改执行合并/变基操作遇到冲突时Git会在冲突文件中标记冲突位置手动解决冲突后执行git add标记为已解决继续完成操作git commit或git rebase --continue# 合并时放弃当前合并回到合并前状态 git merge --abort # 变基时放弃 git rebase --abort记住变基会重写提交历史不要在公共分支上变基我曾经因为在一个团队共享的分支上做rebase导致其他同事pull代码时出现各种问题。4. 高级技巧与实用配置4.1 别名(alias)提高效率在.gitconfig中添加这些别名可以大幅提升效率[alias] co checkout br branch ci commit st status last log -1 HEAD # 查看最后一次提交 unstage reset HEAD -- # 取消暂存 lol log --graph --decorate --oneline --abbrev-commit --all # 漂亮的提交图我最喜欢的是git lol它能直观地展示分支结构比默认的git log清晰多了。4.2 忽略文件的最佳实践.gitignore文件应该放在项目根目录但很多人不知道它可以这样用# 忽略所有.class文件 *.class # 但不忽略特别的Test.class !src/test/Test.class # 忽略特定目录下的所有文件 build/**/*一个常见的错误是在项目中途才添加.gitignore规则这时已经跟踪的文件不会被自动忽略。解决方法git rm -r --cached . # 清除所有缓存 git add . # 重新添加 git commit -m fixed gitignore4.3 找回丢失的代码场景不小心reset --hard了# 查看所有操作记录 git reflog # 找到reset前的commit hash git checkout -b recovery_branch 对应的hash场景删除了未提交的修改# 查看删除的修改 git fsck --lost-found # 检查lost-found目录中的内容我曾经花了三天写的代码因为一个git clean -fd命令全没了最后就是靠git fsck找回来的。从那以后我养成了每天至少commit一次的习惯。5. 团队协作中的Git策略5.1 分支命名规范我们团队采用这样的分支命名规则feature/xxx新功能开发bugfix/xxxbug修复hotfix/xxx紧急线上问题修复release/xxx发布分支这样可以一目了然地知道每个分支的用途。曾经有同事直接在主分支上开发新功能结果导致线上版本出现问题。5.2 Pull Request的最佳实践保持PR小而专注一个PR只解决一个问题或实现一个功能写清晰的描述包括做了什么、为什么做、如何测试使用模板团队可以创建PR模板确保信息完整及时处理评论收到review意见后尽快回应和修改我见过最糟糕的PR是包含了20多个文件修改却只写了修复bug三个字的描述。review这样的PR简直是噩梦。5.3 处理远程仓库问题问题本地分支和远程分支失去同步# 先获取远程最新信息 git fetch origin # 查看本地和远程分支关系 git branch -vv # 重置本地分支到远程分支 git reset --hard origin/分支名问题需要强制推送慎用git push -f origin 分支名强制推送会覆盖远程历史应该在个人分支或紧急情况下使用。我们团队曾经因为有人强制推送主分支导致其他成员无法正常pull代码。6. 我的Git工具箱6.1 图形化工具推荐虽然命令行很强大但有些场景图形工具更直观GitKraken跨平台界面美观适合可视化分支关系SourceTree免费功能全面VS Code Git插件轻量级适合日常简单操作我个人日常使用命令行VS Code Git插件的组合复杂合并时才会打开GitKraken。6.2 实用第三方工具tig终端下的Git浏览器比原生git log强大diff-so-fancy美化git diff输出git-extras提供一系列有用的Git扩展命令安装tig后我几乎不再用普通的git log了# 安装tigMac brew install tig # 使用 tig6.3 自定义Git提示符在.bashrc或.zshrc中添加Git分支信息提示parse_git_branch() { git branch 2 /dev/null | sed -e /^[^*]/d -e s/* \(.*\)/ (\1)/ } export PS1\u\h \W\[\033[32m\]\$(parse_git_branch)\[\033[00m\] $ 这样终端提示符会显示当前所在分支再也不会在错误的分支上提交代码了。7. 那些年我踩过的Git坑7.1 大文件误提交我曾经不小心把几个GB的数据库备份文件commit并push到了远程仓库。解决方法# 安装git-filter-repo pip install git-filter-repo # 从历史中彻底删除大文件 git filter-repo --path 大文件路径 --invert-paths注意这会重写历史需要所有协作者重新clone仓库。7.2 密码泄露事件有次我在代码中硬编码了API密钥并提交了。发现后立即修改密码/密钥使用git filter-repo从历史中删除敏感信息强制推送更新后的仓库现在我会使用环境变量或专门的密钥管理工具来避免这种问题。7.3 分支混乱综合症刚接触Git时我经常创建大量临时分支却不删除导致最后自己都搞不清哪个分支是干什么的。现在我会# 列出已合并到当前分支的分支 git branch --merged # 删除已合并的分支 git branch -d 分支名 # 定期清理远程已删除的分支 git remote prune origin养成定期清理分支的习惯能让仓库保持整洁。