【git经验总结/记录】git仓库拉取时仓库引用导致文件丢失的问题

问题描述

这两天在研究QT的时候想要把github作者zhuzhuchu520做的FluentUI的仓库拉到本地研究研究，结果qt creator打开项目时编译器配置报错说连接不到外部库，具体报错信息如下：

Target "example" links to: FramelessHelper::Core but the target was not found. Possible reasons include: * There is a typo in the target name. * A find_package call is missing for an IMPORTED target. * An ALIAS target is missing.

大概就是example下的CMakeLists.txt文件中代码连接到外部FramelessHelper中的Core模块时没要找到文件，具体代码如下：

target_link_libraries(example PRIVATE
        Qt6::Quick
        Qt6::Svg
        Qt6::Network
        fluentuiplugin
        FramelessHelper::Core
        FramelessHelper::Quick
    )

排查了半天发现原来是因为拉取github上的仓库时如果对象仓库引用了别的仓库会导致文件丢失的，也就是说引用的那部分文件不会一并拉去下来，只保留一个空的文件夹（这非常具有迷惑性）。如图中framelesshelper @ 75ca85e就是引用的仓库，导致如果只拉取这个仓库的话会出现文件夹内没有任何文件的现象。

 

解决方法

 目前没有找到一键解决的方法，只能手动到本地的framelesshelper空文件夹下再拉取一次被引用的仓库，这就导致了很多非常麻烦的操作，比如像这个被引仓库实际上也引用了别的仓库，于是之后还要接着手动拉取别的仓库。还比如引用仓库较多时人工检查容易遗漏。

心得

这也算是血的教训了，被这个问题引发的各种问题折磨了好几个小时，希望这篇经验总结能帮到像我一样的新手。