23.4　隐性子模组

我在开发备份工具Gistore[1]时遇到一个棘手的问题，就是隐性子模组的问题。Gistore备份工具的原理是将要备份的目录都挂载（mount）在工作区中，然后执行git add。但是如果有某个目录已经被Git化了，就只会以子模组的方式将该目录添加进来，而不会添加该目录下的文件。对于一个备份工具来说，这就意味着备份没有成功。具体操作过程如下：

（1）例如当前super版本库下有两个子模组：

$cd/path/to/my/workspace/super-clone/

$git submodule status

126b18153583d9bee4562f9af6b9706d2e104016 lib/lib_a(remotes/origin/HEAD)

3b52a710068edc070e3a386a6efcbdf28bf1bed5 lib/lib_b(heads/master)

（2）然后创建一个新目录others，并把该目录用Git初始化，并做一次空的提交。

$mkdir others

$cd others

$git init

$git commit—allow-empty-m initial

[master(root-commit)90364e1]initial

（3）在others目录下创建一个文件newfile。

$date＞newfile

（4）回到上一级目录执行git status，看到有一个others目录没有加入版本库控制，这很自然。

$cd..

$git status

On branch master

Untracked files:

(use "git add＜file＞…" to include in what will be committed)

#

others/

nothing added to commit but untracked files present(use "git add" to track)

（5）但是如果对others目录执行git add后，会发现奇怪的状态。

$git add others

$git status

On branch master

Changes to be committed:

(use "git reset HEAD＜file＞…" to unstage)

#

new file:others

#

Changed but not updated:

(use "git add＜file＞…" to update what will be committed)

(use "git checkout—＜file＞…" to discard changes in working directory)

(commit or discard the untracked or modified content in submodules)

#

modified:others(untracked content)

#

（6）看看others目录的添加方式，就会发现others目录以gitlink的方式添加到版本库中，而没有把该目录下的文件添加到版本库中。

$git diff—cached

diff—git a/others b/others

new file mode 160000

index 0000000..90364e1

—-/dev/null

+++b/others

@@-0,0+1@@

+Subproject commit 90364e1331abc29cc63e994b4d2cfbf7c485e4ad

之所以上面的步骤（5）运行git status命令时others出现了两次，就是因为目录others被当作子模组添加到了父版本库中，而且由于others版本库本身“不干净”，存在尚未加入版本控制的文件，所以又在状态输出中显示了子模组包含改动的提示信息。

接下来执行提交，将others目录提交到版本库中。然后当执行git submoudle status命令时会报错。因为others作为子模组没有在.gitmodules文件中注册。

$git commit-m "add others as submodule."

$git submodule status

126b18153583d9bee4562f9af6b9706d2e104016 lib/lib_a(remotes/origin/HEAD)

3b52a710068edc070e3a386a6efcbdf28bf1bed5 lib/lib_b(heads/master)

No submodule mapping found in.gitmodules for path 'others'

那么如何在不破坏others版本库的前提下，把others目录下的文件加入版本库呢？即避免others以子模组形式添加入库，具体操作过程如下。

（1）先删除以gitlink形式入库的others子模组。

$git rm—cached others

rm 'others'

（2）查看当前状态。

$git status

On branch master

Changes to be committed:

(use "git reset HEAD＜file＞…" to unstage)

#

deleted:others

#

Untracked files:

(use "git add＜file＞…" to include in what will be committed)

#

others/

（3）重新添加others目录，注意目录后面的斜线（即路径分隔符）非常重要。

$git add others/

（4）再次查看状态，看到others下的文件被添加到super版本库中。

$git status

On branch master

Changes to be committed:

(use "git reset HEAD＜file＞…" to unstage)

#

deleted:others

new file:others/newfile

#

（5）执行提交。

$git commit-m "add contents in others/."

[master 1e0c418]add contents in others/.

2 files changed,1 insertions(+),1 deletions(-)

delete mode 160000 others

create mode 100644 others/newfile

在上面的操作过程中，首先删除了库中的others子模组（使用—cached参数执行删除）；然后为了添加others目录下的文件使用了"others/"（注意others后面的路径分割符“/”）。现在查看一下子模组的状态，会看到只显示出了之前的两个子模组。

$git submodule status

126b18153583d9bee4562f9af6b9706d2e104016 lib/lib_a(remotes/origin/HEAD)

3b52a710068edc070e3a386a6efcbdf28bf1bed5 lib/lib_b(heads/master)

[1]参见本书第7篇“第37章　Gistore”。