如何在Git存储库中移动现有的Git子模块？

我想在我的Git超级项目中更改Git子模块的目录名称。

假设我的.gitmodules文件中包含以下条目：

[submodule ".emacs.d/vimpulse"]  
path = .emacs.d/vimpulse  
url = git://gitorious.org/vimpulse/vimpulse.git

我必须键入什么才能将.emacs.d/vimpulse目录移动到.emacs.d/vendor/vimpulse而不先删除它（在这里和这里说明 ），然后重新添加它。

Git是否真的需要子模块标签中的整个路径

[submodule ".emacs.d/vimpulse"]

还是也可以只存储子项目的名称？

[submodule "vimpulse"]

注意：如评论中所述，此答案指的是旧版本git所需的步骤。Git现在具有移动子模块的本机支持：

从git 1.8.5开始，git mv old/submod new/submod可以按预期工作，并为您完成所有工作。您可能要使用git 1.9.3或更高版本，因为它包含用于子模块移动的修复程序。

该过程类似于您删除子模块的方式（请参阅如何删除子模块？）：

1. .gitmodules适当地编辑和更改子模块的路径，然后使用将其放在索引中git add .gitmodules。
2. 如果需要，请在子模块（mkdir -p new/parent）的新位置创建父目录。
3. 将所有内容从旧目录移动到新目录（mv -vi old/parent/submodule new/parent/submodule）。
4. 确保Git跟踪此目录（git add new/parent）。
5. 使用删除旧目录git rm --cached old/parent/submodule。
6. 将目录.git/modules/old/parent/submodule及其所有内容移到.git/modules/new/parent/submodule。
7. 编辑.git/modules/new/parent/config文件，确保工作树项指向新位置，因此在此示例中，它应为worktree = ../../../../../new/parent/module。通常，..在该位置的直接路径中，目录应该比目录多两个。

8. 编辑文件new/parent/module/.git，确保其中的路径指向主项目.git文件夹中正确的新位置，因此在此示例中gitdir: ../../../.git/modules/new/parent/submodule。

   git status 之后的输出对我来说是这样的：

   # On branch master
   # Changes to be committed:
   #   (use "git reset HEAD <file>..." to unstage)
   #
   #       modified:   .gitmodules
   #       renamed:    old/parent/submodule -> new/parent/submodule
   #
   

9. 最后，提交更改。

最现代的答案，取自Valloric的上述评论：

1. 升级到Git 1.9.3（如果子模块包含嵌套子模块，则升级为2.18）
2. git mv old/submod new/submod
3. 之后，.gitmodules和submodule目录已经准备好提交（您可以使用进行验证git status）。
4. 提交更改，git commit您就可以开始了！

做完了！

就我而言，我想将一个子模块从一个目录移动到一个子目录，例如“ AFNetworking”->“ ext / AFNetworking”。这些是我遵循的步骤：

1. 编辑.gitmodules，将子模块名称和路径更改为“ ext / AFNetworking”
2. 将子模块的git目录从“ .git / modules / AFNetworking”移至“ .git / modules / ext / AFNetworking”
3. 将库从“ AFNetworking”移动到“ ext / AFNetworking”
4. 编辑“ .git / modules / ext / AFNetworking / config”并修复该[core] worktree行。我的从../../../AFNetworking改为../../../../ext/AFNetworking
5. 编辑“ ext / AFNetworking / .git”并修复gitdir。我的从../.git/modules/AFNetworking改为../../git/modules/ext/AFNetworking
6. git add .gitmodules
7. git rm --cached AFNetworking
8. git submodule add -f <url> ext/AFNetworking

最后，我看到了git状态：

matt$ git status
# On branch ios-master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#   modified:   .gitmodules
#   renamed:    AFNetworking -> ext/AFNetworking

等等。上面的示例没有更改目录深度，这对任务的复杂性有很大的影响，并且没有更改子模块的名称（这也许不是必需的，但我这样做是为了与如果我在该路径上添加了新模块，就会发生这种情况。）

[更新：2014-11-26]正如Yar在下面很好地总结的那样，在执行任何操作之前，请确保您知道子模块的URL。如果未知，请打开.git/.gitmodules并检查钥匙submodule.<name>.url。

对我有用的是使用，git submodule deinit <submodule>然后使用删除旧的子模块git rm <submodule-folder>。然后使用新的文件夹名称再次添加子模块并提交。在提交之前检查git status会显示将旧子模块重命名为新名称，并修改.gitmodule。

$ git submodule deinit foo
$ git rm foo
$ git submodule add https://bar.com/foo.git new-foo
$ git status
renamed:    foo -> new-foo
modified:   .gitmodules
$ git commit -am "rename foo submodule to new-foo"

技巧似乎是在了解.git子模块的目录现在保留在主存储库中的下.git/modules，并且每个子模块都有一个.git指向它的文件。这是您现在需要的过程：

• 将子模块移到其新位置。
• .git在子模块的工作目录中编辑文件，然后修改其包含的路径，使其指向主存储库目录中的正确.git/modules目录。
• 输入主存储库的.git/modules目录，然后找到与您的子模块相对应的目录。
• 编辑config文件，更新worktree路径，使其指向子模块工作目录的新位置。
• 编辑.gitmodules主存储库根目录中的文件，将路径更新到子模块的工作目录。
• git add -u
• git add <parent-of-new-submodule-directory>（重要的是添加parent，而不是子模块目录本身。）

一些注意事项：

• 在[submodule "submodule-name"]以行.gitmodules和.git/config必须相互匹配，但不符合任何东西。
• 子模块的工作目录和.git目录必须正确指向彼此。
• 在.gitmodules和.git/config文件应该是同步的。

“ [submodule””后面的引号中的字符串无关紧要。您可以根据需要将其更改为“ foobar”。它用于在“ .git / config”中找到匹配的条目。

因此，如果在运行“ git submodule init”之前进行了更改，它将可以正常工作。如果进行更改（或通过合并进行更改），则需要手动编辑.git / config或再次运行“ git submodule init”。如果执行后者，则将留下一个无害的“绞线”条目，其旧名称位于.git / config中。

您可以仅使用标准命令添加新的子模块并删除旧的子模块。（应防止.git内部出现任何意外错误）

设置示例：

mkdir foo; cd foo; git init; 
echo "readme" > README.md; git add README.md; git commit -m "First"
## add submodule
git submodule add git://github.com/jquery/jquery.git
git commit -m "Added jquery"
## </setup example>

例如将“ jquery”移动到“ vendor / jquery / jquery”：

oldPath="jquery"
newPath="vendor/jquery/jquery"
orginUrl=`git config --local --get submodule.${oldPath}.url`

## add new submodule
mkdir -p `dirname "${newPath}"`
git submodule add -- "${orginUrl}" "${newPath}"

## remove old submodule
git config -f .git/config --remove-section "submodule.${oldPath}"
git config -f .gitmodules --remove-section "submodule.${oldPath}"
git rm --cached "${oldPath}"
rm -rf "${oldPath}"              ## remove old src
rm -rf ".git/modules/${oldPath}" ## cleanup gitdir (housekeeping)

## commit
git add .gitmodules
git commit -m "Renamed ${oldPath} to ${newPath}"

大型子模块的奖励方法：

如果子模块很大，并且您不想等待克隆，则可以使用旧的作为原点创建新的子模块，然后切换原点。

示例（使用相同的示例设置）

oldPath="jquery"
newPath="vendor/jquery/jquery"
baseDir=`pwd`
orginUrl=`git config --local --get submodule.${oldPath}.url`

# add new submodule using old submodule as origin
mkdir -p `dirname "${newPath}"`
git submodule add -- "file://${baseDir}/${oldPath}" "${newPath}"

## change origin back to original
git config -f .gitmodules submodule."${newPath}".url "${orginUrl}"
git submodule sync -- "${newPath}"

## remove old submodule
...

给定的解决方案对我不起作用，但是类似的版本却适用...

这是一个克隆的存储库，因此子模块git repos包含在顶级存储库.git dir中。所有阳离子均来自顶部的存储库：

1. 编辑.gitmodules并更改相关子模块的“ path =”设置。（无需更改标签，也无需将此文件添加到索引。）

2. 编辑.git / modules / name / config并更改所涉及子模块的“ worktree =”设置

3. 跑：

   mv submodule newpath/submodule
   git add -u
   git add newpath/submodule
   

我想知道存储库是原子库还是相对子模块是否会有所不同，在我的情况下，它是相对的（submodule / .git是对topproject / .git / modules / submodule的引用）

只需使用shell脚本git-submodule-move即可。

我昨天刚刚经历了这个磨难，这个答案非常有效。为了清楚起见，这是我的步骤：

1. 确保已检入子模块并将其推送到其服务器。您还需要知道它的分支。
2. 您需要子模块的URL！使用more .gitmodules是因为一旦删除子模块，它将不再存在
3. 现在您可以使用deinit，rm然后submodule add

例

• Git子模块位于：Classs / lib / mustIReally
• 移至：lib / AudioBus
• 网址：http：//developer.audiob.us/download/SDK.git

指令

    git submodule deinit Classes/lib/mustIReally
    git rm foo
    git submodule add http://developer.audiob.us/download/SDK.git lib/AudioBus

    # do your normal commit and push
    git commit -a 

注意： git mv不会这样做。完全没有