user$ sudo git submodule update
fatal: reference is not a tree: a094dcfeeb43fcd62a9e466156e05e7581026f33
Unable to checkout 'a094dcfeeb43fcd62a9e466156e05e7581026f33' in submodule path 'client/src/util'
我该怎么办？我只是想从 repo 中获得最新代码的干净副本，我不介意丢失我的更改。 正如你所知道的，我显然不确定发生了什么。我只能认为它正在尝试签出一个文件，这意味着 git 检测到我本地机器上的文件中的本地更改。
我目前正在使用 OSX
【问题讨论】：
标签： git version-control
您的子模块存储库很可能没有引用外部存储库的修订。它也可能在为子模块指定的远程不可用，或者您没有为子模块设置远程。您可以尝试在其中进入client/src/util 和git fetch。
（你为什么sudo它？如果它属于root，为什么你不在root shell中，如果不是，你为什么要切换到root？）
【讨论】：
sudo 它才能进行写入
这是子模块最常见的问题。您在外部存储库中的提交引用了子模块中尚未有人推送的提交。这是一个依赖问题。始终从内向外推动。这很可能不是您做错了什么，而是在存储库中工作的其他人。他们马虎，忘记在子模块上发布推送，只是推送了包含的存储库。 Stuff 在他们的机器上工作，因为他们进行了更改并且那些提交存在那里。去打他们一巴掌，告诉他们推动他们的子模块更改:)
否则，如果您在另一台机器上工作并且忘记推送子模块更改，则可能是您的错。现在您在另一个位置并且正在思考“发生了什么！这些是我的更改，它们也应该在这里工作！”
【讨论】：
大多数情况下是 Adam Dymitruk 所描述的情况，但另一种可能导致这种情况的情况是切换具有更改遥控器的子模块的分支时。这是因为子模块更新只是尝试检查提交，但在添加和获取新远程之前它无法做到。
您可以通过查看 .gitmodules 文件并将子模块的 URL 与 cd'ing 到子模块并执行 git remote -v 显示的 URL 进行比较来验证这一点
在这种情况下，您需要运行 git submodule sync 来通知子模块远程更改，然后运行 git submodule update --init --recursive 以消除此错误。
【讨论】：
除了 Adam Dymitruk 和 Michael Chien 的回答之外，由于 Windows 最大路径长度，我遇到了这个问题。如果我尝试在我的Documents/Visual Studio 2013/Projects 目录中克隆具有 3 级深度子模块的特定存储库，那么我会得到fatal: reference is not a tree。但是如果我在我的主目录中重复相同的克隆，它就可以正常工作。
【讨论】：
该错误意味着在克隆子模块时无法从任何引用访问特定提交（其 sha1），因此您应该使用有效引用更新子模块或将更改重置为最新版本。
当您在本地分支中进行了新提交，或者您包含了对分离的 HEAD 的引用，但您没有将它们推送到子模块 git URL 指向的主存储库中时，可能会发生这种情况。
要手动将子模块重置为源/主，输入子模块的子目录并进行重置，例如
cd client/src/util
git reset origin/master --hard
如果您想更正主仓库中的引用，请在执行上述操作后提交更改：
# Still in submodule dir.
git pull origin master # In submodule dir.
git push origin master
cd - # Go back to the main repo dir.
git status
git commit -am 'Update submodule refs'
git push
如果您想将引用从 fork 拉取并推送到 origin，您可以尝试：
cd client/src/util # Go to submodule dir again.
git remote add fork git@github.com:example/foo.git
git pull fork master
git show a094dcfeeb43fcd62a9e466156e05e7581026f33 # Check previously missing sha1.
git push origin master:master # Or: master:some_branch
【讨论】：