“[submodule”后面引号中的字符串并不重要。如果你愿意，你可以把它改成“foobar”。它用于在“.git/config”中查找匹配的条目。

因此，如果你在运行"git submodule init"之前进行更改，它会正常工作。如果你做了更改(或通过合并进行更改)，你需要手动编辑.git/config或再次运行"git submodule init"。如果您选择后者，您将在.git/config中留下一个带有旧名称的无害的“搁浅”条目。

更新版本的git

Git现在支持移动子模块:

从git 1.8.5开始，git mv old/submod new/submod就像预期的那样工作，并为你做了所有的管道工作。您可能希望使用git 1.9.3或更新版本，因为它包含了针对子模块移动的修复。

git的旧版本

正如评论中提到的，这个答案指的是旧版本git所需的步骤。

这个过程类似于如何删除子模块(参见如何删除子模块?):

Edit .gitmodules and change the path of the submodule appropriately, and put it in the index with git add .gitmodules. If needed, create the parent directory of the new location of the submodule (mkdir -p new/parent). Move all content from the old to the new directory (mv -vi old/parent/submodule new/parent/submodule). Make sure Git tracks this directory (git add new/parent). Remove the old directory with git rm --cached old/parent/submodule. Move the directory .git/modules/old/parent/submodule with all its content to .git/modules/new/parent/submodule. Edit the .git/modules/new/parent/config file, make sure that worktree item points to the new locations, so in this example it should be worktree = ../../../../../new/parent/module. Typically there should be two more .. than directories in the direct path in that place. Edit the file new/parent/module/.git, make sure that the path in it points to the correct new location inside the main project .git folder, so in this example gitdir: ../../../.git/modules/new/parent/submodule. git status output looks like this for me afterwards: # On branch master # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # modified: .gitmodules # renamed: old/parent/submodule -> new/parent/submodule # Finally, commit the changes.

给出的解决方案对我不起作用，然而一个类似的版本却起作用了。

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

编辑.gitmodules并更改相关子模块的"path ="设置。(不需要更改标签，也不需要将该文件添加到索引。) 编辑.git/modules/name/config，修改子模块的"worktree ="设置 运行: Mv submodule newpath/submodule Git add -u Git增加了新路径/子模块

我想知道如果存储库是原子的，还是相对的子模块，在我的情况下，它是相对的(submodule/。Git是一个指向topproject/.git/modules/submodule的引用)

在我的例子中，我想将一个子模块从一个目录移动到另一个子目录，例如:"AFNetworking" -> "ext/AFNetworking"以下是我遵循的步骤:

Edit .gitmodules changing submodule name and path to be "ext/AFNetworking" Move submodule's git directory from ".git/modules/AFNetworking" to ".git/modules/ext/AFNetworking" Move library from "AFNetworking" to "ext/AFNetworking" Edit ".git/modules/ext/AFNetworking/config" and fix the [core] worktree line. Mine changed from ../../../AFNetworking to ../../../../ext/AFNetworking Edit "ext/AFNetworking/.git" and fix gitdir. Mine changed from ../.git/modules/AFNetworking to ../../git/modules/ext/AFNetworking git add .gitmodules git rm --cached AFNetworking 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

瞧。上面的例子没有改变目录深度，这对任务的复杂性有很大影响，也没有改变子模块的名称(这可能真的没有必要，但我这样做是为了与在该路径添加新模块时发生的情况保持一致)。

诀窍似乎是理解子模块的.git目录现在保存在主存储库中，在.git/modules下，每个子模块都有一个指向它的.git文件。这是你现在需要的程序:

Move the submodule to its new home. Edit the .git file in the submodule's working directory, and modify the path it contains so that it points to the right directory in the master repository's .git/modules directory. Enter the master repository's .git/modules directory, and find the directory corresponding to your submodule. Edit the config file, updating the worktree path so that it points to the new location of the submodule's working directory. Edit the .gitmodules file in the root of the master repository, updating the path to the working directory of the submodule. git add -u git add <parent-of-new-submodule-directory> (It's important that you add the parent, and not the submodule directory itself.)

注意事项:

.gitmodules和.git/config中的[submodule "submodule-name"]行必须相互匹配，但不对应任何其他内容。 子模块的工作目录和.git目录必须正确指向对方。 .gitmodules和.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
...

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

[更新:2014-11-26]正如Yar在下面总结的那样，在你做任何事情之前，确保你知道子模块的URL。如果未知，打开.git/。<name>.url。

对我有用的是使用git子模块deinit <submodule>和git rm <submodule-folder>删除旧的子模块。然后用新的文件夹名再次添加子模块并提交。在提交前检查git状态会显示旧子模块重命名为新名称，.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"

我昨天刚刚经历了这个考验，这个答案非常有效。为了清晰起见，以下是我的步骤:

确保子模块被签入并推入到它的服务器。你还需要知道它在哪个分支上。 您需要子模块的URL !使用更多的.gitmodules，因为一旦你删除了子模块，它就不存在了 现在你可以使用deinit, rm和submodule add

例子

Git子模块在:Classes/lib/mustIReally 移动到:lib/AudioBus URL: 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不这样做。在所有。

最现代的答案来自Valloric的评论:

升级到Git 1.9.3(如果子模块包含嵌套子模块，则升级到2.18) Git mv old/submod new/submod 之后.gitmodules和子模块目录已经被提交(你可以用git status来验证这一点)。 使用git Commit提交更改-你就可以开始了!

完成了!

我遇到同样的问题并成功地解决了它。感谢您在Github发布delete_git_submodule.md

要移除一个子模块，你需要:

从.gitmodules文件中删除相关的部分。 阶段。gitmodules的变化，git添加。gitmodules 从.git/config中删除相关的部分。(也许并不存在) 运行git rm——cached path_to_submodule(没有后面的斜杠)。 执行rm -rf .git/modules/path_to_submodule(没有后面的斜杠)。 Commit -m "已删除的子模块" 删除现在不跟踪的子模块文件rm -rf path_to_submodule

对于我来说，运行git mv <old/path> <new/path失败:

Rename from 'old/path' to 'new/path' failed. Should I try again? (y/n)

在运行git deinit <old/path>后，我能够使用git mv。