Git(1) 常见问题及解决办法_详细版_fatal: unable to read tree

Git是一个非常强大和灵活的版本控制系统，但也会遇到一些问题和错误。本文将介绍一些Git常见问题及解决办法，帮助你更好地使用Git。

前言

Git也不是完美的，有时候会出现一些问题和错误，常见比如：

• 网络问题，导致无法连接远程仓库或者传输数据失败。
• 冲突问题，导致无法合并分支或者提交更改。
• 文件问题，导致无法读取或者写入文件或者目录。
• 配置问题，导致无法正确设置或者使用Git的功能或者选项。

这些问题可能会让我们头皮发麻，不要担心，本文将为你提供一些常见问题及解决办法，如果我后面还有GIT相关问题 我会补充到这篇文章中。

问题1：fatal: unable to read tree

如果在执行git status命令时遇到了fatal: unable to read tree的错误，可能是因为的.git目录中的某些文件被损坏了。这可能是由于磁盘故障等原因造成的。

解决办法：

• 如果有备份或者克隆了远程仓库，可以尝试从备份或者远程仓库恢复损坏的文件。
• 如果你有备份或者克隆了远程仓库，可以尝试使用git fsck命令来检查并修复损坏的文件。如果修复成功，可以继续使用git status命令查看状态。如果修复失败，可能需要重新初始化一个新的仓库，并且重新添加和提交的文件。
• 如果你既修复不成功， 也没备份远程分支 凉凉。

示例：

# 假设mstar项目遇到了这个问题
git status
fatal: unable to read tree 390b54109ff2aba9c01a93c352251a9b562ec1c6

# 尝试从远程仓库恢复
git fetch origin
git reset --hard origin/master

# 或者尝试使用git fsck修复
git fsck --full
Checking object directories: 100% (256/256), done.
Checking objects: 100% (1024/1024), done.
error: refs/heads/master does not point to a valid object!
error: refs/remotes/origin/master does not point to a valid object!
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
error: 390b54109ff2aba9c01a93c352251a9b562ec1c6: invalid sha1 pointer in cache-tree
dangling blob 4f3d8f8f7e5f8f7e5f8f7e5f8f7e5f8f7e5f8f7e
dangling blob 3d2f7f6f6e4f6e4f6e4f6e4f6e4f6e4f6e4f6e4f
dangling blob 2d1f6e5e5d4e5d4e5d4e5d4e5d4e5d4e5d4e5d4e

# 如果修复成功，继续使用git status
git status
On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

# 如果修复失败，重新初始化一个新的仓库，并且重新添加和提交你的文件
rm -rf .git
git init
git add .
git commit -m "Initial commit"
git remote add origin https://gitee.com/mstar/mstar.git
git push -u origin master
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

问题2：error: remote origin already exists.

如果在执行git remote add origin命令时遇到了error: remote origin already exists.的错误，可能是因为已经关联了一个名为origin的远程仓库，而又想关联一个不同的远程仓库。这可能是由于克隆了别人的仓库，在此基础上完成的代码，推送到自己的仓库时造成的。

解决办法：

• 如果想保留原来的远程仓库，可以使用不同的名字来关联新的远程仓库，比如git remote add new-origin https://gitee.com/xxxxxx.git。
• 如果想替换原来的远程仓库，可以先使用git remote rm origin命令来删除关联的origin的远程库，然后再使用git remote add origin https://gitee.com/xxxxxx.git命令来关联新的远程仓库。

示例：

# 假设克隆了别人的仓库，并且完成了你的代码，想推送到自己的仓库

# 尝试关联自己的仓库
git remote add origin https://gitee.com/xxxxxx.git
error: remote origin already exists.

# 保留原来的远程仓库，使用不同的名字来关联新的远程仓库
git remote add new-origin https://gitee.com/xxxxxx.git

# 或者替换原来的远程仓库，先删除关联的origin的远程库，再关联新的远程仓库
git remote rm origin
git remote add origin https://gitee.com/xxxxxx.git

# 最后推送到自己的仓库
git push -u origin master
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

问题3：Updates were rejected because the tip of your current branch is behind

如果在执行git push命令时遇到了Updates were rejected because the tip of your current branch is behind的错误，可能是因为本地分支落后于远程分支，导致无法推送你的更改。这可能是由于在推送之前没有拉取远程分支的最新更改造成的。

解决办法：

• 如果你想保留远程分支的更改，可以先使用git pull命令来拉取并合并远程分支的最新更改，然后再使用git push命令来推送你的更改。如果合并过程中出现冲突，需要先解决冲突，然后再提交和推送。
• 如果想覆盖远程分支的更改，你可以使用git push -f命令来强制推送你的更改，这样会把远程分支的历史重写为你的本地分支的历史。注意，这是一个危险的操作(自己负责)，可能会导致其他人的工作丢失，所以请谨慎使用。

示例：

# 假设你在本地分支master上完成了你的代码，想推送到远程分支master

# 尝试推送
git push
To github.com:xxx/xxx_blog.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'github.com:xxx/xxx_blog.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

# 拉取并合并远程分支的最新更改
git pull
From github.com:xxx/xxx_blog
 * [new branch]      master     -> origin/master
Merge made by the 'recursive' strategy.
 README.md | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 README.md

# 或者强制推送覆盖远程分支的更改
git push -f
Counting objects: 3, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 328 bytes | 328.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To github.com:xxx/xxx_blog.git
 + 11bbalf...900252a master -> master (forced update)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

问题4：如果误删了.git/index

如果误删了.git/index文件，会导致git status命令显示所有的文件都是未跟踪的，即使没有修改过它们。这是因为.git/index文件是一个缓存文件，它记录了你的工作区和暂存区的状态，以及最近一次提交的快照。如果删除了这个文件，Git就无法正确地比较你的工作区和暂存区和提交之间的差异。卧槽™当时吓死我了，别慌 看我的处理经验!

解决办法：

• 如果有备份或者克隆了远程仓库，可以尝试从备份或者远程仓库恢复.git/index文件。
• 如果没有备份或者克隆了远程仓库，可以尝试使用git reset命令来重建.git/index文件。这个命令会把你的暂存区重置为你指定的提交的快照，并且重新生成.git/index文件。请注意，这个命令不会影响你的工作区，所以需要先把你修改过的文件备份起来，然后再执行这个命令。

示例：

# 假设你误删了.git/index文件

# 尝试从远程仓库恢复
git fetch origin
cp .git/refs/remotes/origin/master .git/index

# 或者尝试使用git reset重建
# 先把修改过的文件备份起来
cp -r src src_backup
cp -r test test_backup

# 然后执行git reset命令
git reset
Unstaged changes after reset:
M       src/main.c
M       test/test.c

# 最后把备份的文件还原回来
cp -r src_backup/* src
cp -r test_backup/* test
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

问题5：如果不想通过git status看到文件模式的更改

每次改个文件权限后通过git status查看就是一篇红，看着头皮发麻， 如果不想通过git status命令看到文件模式（也就是文件权限）的更改，比如：

$ git status
On branch master
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   README.md (mode change 100644 => 100755)

no changes added to commit (use "git add" and/or "git commit -a")
1
2
3
4
5
6
7
8

可以使用git config命令来配置Git忽略文件模式变化。在Git 2.9及以上版本中，可以通过以下方式设置：

git config core.filemode false
1

其中--global选项是可选的，如果使用，则会将该配置应用于所有存储库。

此配置告诉Git在比较文件时忽略文件模式更改，从而不会将其报告为未提交更改。请注意，这不影响Git应用文件模式更改; 它只是影响Git如何显示文件模式更改。

请注意，如果你使用旧版本的Git，则可能无法使用该选项。在这种情况下，最好的方法是使用.gitignore文件忽略文件模式变化。具体方法请参考这里。

问题6：网络防火墙阻止了HTTPS协议的访问

如果在执行git clone命令时遇到了网络防火墙阻止了HTTPS协议的访问的问题，可能是因为所在的网络环境不允许使用HTTPS协议来访问远程仓库，而只允许使用HTTP协议。这可能是由于你所在的网络环境有一些安全策略或者限制造成的。

解决办法：

• 如果可以更改你所在的网络环境，可以尝试使用一个不受限制的网络环境来访问远程仓库，比如使用V-P-N或者呆理等方式。
• 如果不能更改你所在的网络环境，可以尝试使用HTTP协议来访问远程仓库，只需要把远程仓库的URL中的https替换为http即可。请注意，这样做可能会降低你的数据安全性，因为HTTP协议不是加密的。

示例：

# 假设你想克隆LiteOS仓库

# 尝试使用HTTPS协议
git clone https://gitee.com/LiteOS/LiteOS.git
Cloning into 'LiteOS'...
fatal: unable to access 'https://gitee.com/LiteOS/LiteOS.git/': Failed to connect to gitee.com port 443: Connection refused

# 使用HTTP协议
git clone http://gitee.com/LiteOS/LiteOS.git
Cloning into 'LiteOS'...
remote: Enumerating objects: 109, done.
remote: Counting objects: 100% (109/109), done.
remote: Compressing objects: 100% (76/76), done.
remote: Total 109 (delta 25), reused 0 (delta 0), pack-reused 0
Receiving objects: 100% (109/109), 1.12 MiB | 1.01 MiB/s, done.
Resolving deltas: 100% (25/25), done.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

问题7：fetch --nohooks chromium

想拉取最新的chromium代码，可以使用fetch --nohooks chromium命令来执行这个操作。这个命令会从远程仓库拉取所有的分支和标签，并且更新你的本地分支和远程跟踪分支。--nohooks选项表示不执行任何钩子脚本，这样可以加快拉取的速度。

如果你不需要特定版本的chromium，推荐使用fetch --nohooks chromium --no-history命令，加入--no-history选项能少下载接近一半的数据量，因为它会只拉取最新的提交，而不是整个历史。这样可以节省你的网络流量和磁盘空间。

如果需要特定版本的chromium，必须全量拉取，否则切换版本时错误较多，一个个修复相当麻烦。可以使用fetch --nohooks chromium --force命令来强制全量拉取，这样会覆盖你本地的任何更改，并且保证你和远程仓库完全同步。注意，这是一个危险的操作，可能会导致你的工作丢失，所以用了自己负责哈。

示例：

# 拉取最新的chromium代码
fetch --nohooks chromium
Running: git -c core.deltaBaseCacheLimit=2g clone --no-checkout --progress https://chromium.googlesource.com/chromium/src.git /home/user/chromium/src
Cloning into '/home/user/chromium/src'...
remote: Sending approximately 1.01 GiB ...
remote: Counting objects: 1, done
remote: Finding sources: 100% (1/1)
remote: Total 1 (delta 0), reused 1 (delta 0)
Receiving objects: 100% (1/1), 1.01 GiB | 2.00 MiB/s, done.
Running: git -c core.deltaBaseCacheLimit=2g rev-parse --verify HEAD
Running: git config branch.master.remote origin
Running: git config branch.master.merge refs/heads/master
Running: git config remote.origin.url https://chromium.googlesource.com/chromium/src.git
Running: git config remote.origin.fetch +refs/branch-heads/*:refs/remotes/branch-heads/* +refs/tags/*:refs/tags/*
Running: git config remote.origin.mirror true

# 拉取最新的chromium代码，不拉取历史
fetch --nohooks chromium --no-history
Running: git -c core.deltaBaseCacheLimit=2g clone --depth=1 --no-checkout --progress https://chromium.googlesource.com/chromium/src.git /home/user/chromium/src
Cloning into '/home/user/chromium/src'...
remote: Sending approximately 551.63 MiB ...
remote: Counting objects: 1, done
remote: Finding sources: 100% (1/1)
remote: Total 1 (delta 0), reused 1 (delta 0)
Receiving objects: 100% (1/1), 551.63 MiB | 2.00 MiB/s, done.
Running: git -c core.deltaBaseCacheLimit=2g rev-parse --verify HEAD
Running: git config branch.master.remote origin
Running: git config branch.master.merge refs/heads/master
Running: git config remote.origin.url https://chromium.googlesource.com/chromium/src.git
Running: git config remote.origin.fetch +refs/branch-heads/*:refs/remotes/branch-heads/* +refs/tags/*:refs/tags/*
Running: git config remote.origin.mirror true

# 强制全量拉取特定版本的chromium代码
fetch --nohooks chromium --force
Running: git -c core.deltaBaseCacheLimit=2g fetch origin +refs/heads/* +refs/tags/* +refs/branch-heads/* +refs/change/* +refs/gerrit/* +refs/heads/*:refs/remotes/origin/* +refs/tags/*:refs/tags/* +refs/branch-heads/*:refs/remotes/branch-heads/* +refs/change/*:refs/remotes/change/* +refs/gerrit/*:refs/remotes/gerrit/*
remote: Sending approximately 1.01 GiB ...
remote: Counting objects: 1, done
remote: Finding sources: 100% (1/1)
remote: Total 1 (delta 0), reused 1 (delta 0)
Receiving objects: 100% (1/1), 1.01 GiB | 2.00 MiB/s, done.
Running: git -c core.deltaBaseCacheLimit=2g reset --hard origin/master
HEAD is now at 900252a Initial commit
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

问题8：2021年2/3 日 .git/index.lock

在执行git命令时遇到了.git/index.lock文件的问题，可能是因为你的.git目录中存在一个名为index.lock的文件，它是一个锁文件，用来防止多个进程同时修改.git/index文件。这个文件通常会在git命令执行完毕后自动删除，但有时候可能会因为某些原因（比如程序崩溃等）而残留在.git目录中，导致你无法执行其他的git命令。注意删的时候别敲错了 不然你可能会遇到问题4。

解决办法：

• 如果确定没有其他的进程在使用git命令，可以尝试手动删除.git/index.lock文件，然后再执行你想要的git命令。
• 如果不确定是否有其他的进程在使用git命令，可以尝试使用ps -ef | grep git命令来查看是否有其他的进程在运行git命令，如果有，可以等待它们结束或者杀死它们，然后再删除.git/index.lock文件。

示例：

# 假设你想执行git status命令

# 尝试执行
git status
fatal: Unable to create '/home/user/chromium/src/.git/index.lock': File exists.

Another git process seems to be running in this repository, e.g.
an editor opened by 'git commit'. Please make sure all processes
are terminated then try again. If it still fails, a git process
may have crashed in this repository earlier:
remove the file manually to continue.

# 确定没有其他进程在使用git命令，手动删除.git/index.lock文件
rm -rf .git/index.lock

# 或者查看是否有其他进程在运行git命令
ps -ef | grep git
user     1234  1233  0 10:00 pts/0    00:00:00 git commit
user     1235  1234  0 10:00 pts/0    00:00:00 vim .git/COMMIT_EDITMSG
user     1236  1235  0 10:00 pts/0    00:00:00 git status

# 等待或者杀死其他进程
kill -9 1234
kill -9 1235
kill -9 1236

# 然后再删除.git/index.lock文件
rm -rf .git/index.lock

# 最后再执行想要的git命令
git status
On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

问题9：index-pack failed

如果你在执行git clone命令时遇到了index-pack failed的错误，可能是因为在传输数据的过程中发生了一些问题，导致数据不完整或者损坏。这可能是由于网络不稳定、远程仓库不可用、磁盘空间不足等原因造成的。

解决办法：

• 如果你怀疑是网络不稳定的原因，你可以尝试使用git config命令来增加HTTP传输的缓冲区大小，比如：

  git config --global http.postBuffer 524288000
  1

  这样可以减少传输过程中的分包和重连，提高传输效率。然后再重新克隆远程仓库。

• 如果你怀疑是远程仓库不可用的原因，你可以尝试访问远程仓库的网页，看是否能正常打开，或者使用ping命令来测试网络连通性，比如：

  ping gitee.com
  1

  如果网页无法打开或者网络不通，说明远程仓库有问题，你需要等待它恢复正常后再重新克隆。

• 如果你怀疑是磁盘空间不足的原因，你可以尝试使用df -h命令来查看你的磁盘空间使用情况，比如：

  df -h
  Filesystem      Size  Used Avail Use% Mounted on
  /dev/sda1       100G   80G   15G  85% /
  /dev/sda2       200G   50G  140G  25% /home
  1
  2
  3
  4

  如果你发现你的磁盘空间不足，你需要清理一些不必要的文件或者扩大你的磁盘空间，然后再重新克隆远程仓库。

示例：

# 假设你想克隆一个远程仓库

# 尝试克隆
git clone https://gitee.com/xxxxxx.git
Cloning into 'xxxxxx'...
remote: Enumerating objects: 1024, done.
remote: Counting objects: 100% (1024/1024), done.
remote: Compressing objects: 100% (512/512), done.
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: the remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

# 增加HTTP传输的缓冲区大小
git config --global http.postBuffer 524288000

# 再重新克隆远程仓库
git clone https://gitee.com/xxxxxx.git
Cloning into 'xxxxxx'...
remote: Enumerating objects: 1024, done.
remote: Counting objects: 100% (1024/1024), done.
remote: Compressing objects: 100% (512/512), done.
Receiving objects: 100% (1024/1024), 1.00 MiB | 1.00 MiB/s, done.
Resolving deltas: 100% (256/256), done.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

总结

本文介绍了一些Git常见问题及解决办法，希望能够帮助你更好地使用Git。当然，Git还有很多其他的问题和功能，如果你想了解更多，你可以参考以下的资源：

• Git官方文档
• Git常见问题解答
• Git教程

感谢你阅读本文，如果你有任何问题或者建议，欢迎留言或者联系我。