详解git submodule update获取不到最新提交的代码

今天遇到了一个git submodule update获取不到最新代码的问题，闹了半天原来是自己对git submodule理解不到位引起的。解决了后，感觉虽然没有什么高深的地方，但是不清楚的时候还是需要费时间去查找问题，所以还是在此记录如下。

1.问题描述

同事在共同使用的一个工程里修改了代码，这个工程在我本地的工程中是作为submodule来使用的，但是我在本地执行以下命令却获取不到最新提交的代码。

git submodule update --init --recursive

2.问题原因

git submodule在工程中维护了一个文件.gitmodules文件，里边记录了子工程在当前父工程下的存放路径path和子工程的git路径url。同时，在父工程下的.git目录中，还有个modules子目录如下所示。

在这个modules中存放的就是父工程相关的子工程的路径。进入子工程后，可以看到里边有个叫做FETCH_HEAD的文件：

查看该文件的内容如下：

zhuwsh@zhuwsh-TM1705:~/work_space/autonomousDriving/.git/modules/src/utils/dw_xxx_center$ cat FETCH_HEAD

31ecb3458596f22134588460eefb9efa4bd6df23 branch 'master' of https://gitlab.xxx.com/xxx/dw_xxx_center

此时可以发现，这里的commit id和git上最新提交的commitid不一样，这里的commit id还是之前某一次的提交id。

这个其实要说明的是，git submodule update获取代码的时候是和子工程的git路径和这里的commit id有关联的，获取的就是对应的git路径下截止这个commit id的所有代码，之后的代码是不会获取到的。

明白了这个原理后，就知道怎么来修改了。

3.解决方法

既然git远端服务器代码已经修改过了，那么本地每次执行了git submodule update --init --recursive命令后自然需要在自工程对应的路径下执行git pull命令，执行完后服务器端的最新代码就更新到本地了。这个操作做完后再执行git submodule update命令，此时就可以看到上边说的FETCH_HEAD文件中的commit id发生了变化，已经变为当前最新的commit id了。

zhuwsh@zhuwsh-TM1705:~/work_space/autonomousDriving/.git/modules/src/utils/dw_xxx_center$ cat FETCH_HEAD

ab214ead574d51755f4faabad4045de6486b49c2 branch 'master' of https://gitlab.xxx.com/xxx/dw_xxx_center

总结一下就是，在使用git submodule update --init --recursive获取了自工程代码后，还需要执行下面两条命令：

git pull
git submodule update