技术学堂
本文总结了git使用中经常遇到的一些问题，如网络问题、磁盘问题、代码冲突问题、版本迭代问题、文件缺失问题等等，以及各种故障对应的解决方案。
克隆代码时遇到问题
报错内容：index-pack failed
故障分析：网络不稳定、远程仓库不可用、磁盘空间不足等原因都会在克隆代码时导致数据不完整或者损坏。
解决方案：网络不稳定的情况下，增加HTTP传输的缓冲区大小，减少传输过程中的分包和重连，提高传输效率。
git config --global http.postBuffer 524288000
解决方案：检查本地磁盘空间是否足够，如果是磁盘空间不足，先清理文件后再重新克隆仓库。
拉取代码时遇到错误
报错内容：Your local changes to the following files would be overwritten by merge
故障分析：本地有未提交的代码
解决方案：暂存本地已更改的代码，并把服务器上的代码拉取到本地
git stash git pull origin master git stash pop
解决方案：服务器端代码覆盖本地的代码
git reset --hard git pull origin master
相关命令解析
| git pull | 拉取服务器上的代码至本地，完整命令：git pull <远程主机名> <本地分支名>:<远程分支名> |
| git stash | 备份当前工作区内容，从最近的一次提交中读取相关内容，让工作区保证和上次提交的内容一致，同时将当前工作区内容保存到git栈中 |
| git stash list | 显示git栈内的所有备份，如stash@{0}...如stash@{99}，即stash的标识符，通过这个列表来决定从哪个地方恢复 |
| git stash apply <标识符> | 应用指定的stash，不会被删除 |
| git stash drop <标识符> | 删除指定的stash |
| git stash pop | 取栈顶的内容并恢复，以保证最后stash的内容被最先取到，即从git栈中读取最近一次保存的内容恢复至工作区 |
| git stash clear | 清空git栈 |
报错内容：无法更新最新代码（缺少文件）
故障分析：本地文件丢失
解决方案：查看文件状态，将本地已删除的文件进行恢复恢复
git status
解决方案：提交本地已更新的代码后再拉取服务器代码
合并代码时遇到冲突
故障分析：协同开发时对同一文件进行了修改
解决方案：更新代码后再提交，以"git merge feature_zhilin"为例
# 查看有冲突的文件 git status vim 编译存在冲突的文件 <<<<<<< HEAD 当前分支的代码 ======= 等待合并的代码 >>>>>>> feature_zhilin # 添加代码 git add 存在冲突的文件 # 提交代码，此时不要带文件名 git commit -m "提交……"
查询文件状态时间遇到问题
报错内容：fatal: unable to read tree
故障分析：可能是.git目录中的某些文件被损坏
解决方案：在有远程备份仓库的情况下从远程仓库恢复
git fetch origin git reset --hard origin/master
解决方案：在有远程备份仓库的情况通过命令修复损坏的文件，如果修复失败，则初始化一个新仓库并重新添加和提交的文件。
git fsck --full # 如果修复成功成功 git status # 如果修复失败 rm -rf .git git init git add . git commit -m "Initial commit" git remote add origin https://gitmodel.com/model/model.git git push -u origin master
将代码添加至远程仓库时遇到问题
报错内容：error: remote origin already exists.
故障分析：本地原有仓库克隆了来自其他远程仓库origin的代码。
解决方案：保留原来的远程仓库，用不同的名字来关联新的远程仓库，
git remote add new-origin https://gitmodel.com/model.git
解决方案：替换原来的远程仓库，先删除已关联的origin远程仓库，再关联新的。
git remote rm origin git remote add origin https://gitmodel.com/model.git git push -u origin master
推送代码时遇到问题
报错内容：Updates were rejected because the tip of your current branch is behind
故障分析：本地分支落后于远程分支，在推送之前没有更新远程代码导致。
解决方案：保留远程分支的更改，先拉取且合并远程分支的最新更改，如果合并过程中出现冲突，在解决完冲突后再推送本地更改的代码。
解决方案：覆盖远程分支的更改，但是会把远程分支的历史重写为你的本地分支的历史，在协同开发时将丢失他人的更改，请慎用。
git push -f
误删缓存文件.git/index
文件.git/index记录用于记录工作区和暂存区的状态，以及最近一次提交的快照，被删除后，git无法正确地比较工作区、暂存区和提交之间的差异。
解决方案：有备份或者克隆了远程仓库的情况，可以尝试从备份或者远程仓库恢复
git fetch origin cp .git/refs/remotes/origin/master .git/index
解决方案：无备份或者未克隆远程仓库的情况，重建.git/index文件，把暂存区重置为你指定的提交的快照，该操作不影响工作区，执行前须先备份修改过的文件。
cp -r src src_backup git reset cp -r src_backup/* src/
执行命令时遇到.git/index.lock文件
文件.git/index.lock是一个文件锁，用来防止多个进程同时修改.git/index文件，它通常会在git命令执行完毕后自动删除，但有时候会因为某些原因（比如程序崩溃等）而残留在.git目录。
解决方案：找到并杀死正在运行git命令的进程，然后手动删除.git/index.lock文件。
ps -ef | grep git | awk '{print $2}' | xargs kill -9
rm -rf .git/index.lock
原创文章禁止转载：技术学堂 » Git操作常见问题及解决方案
