在我的例子中，我想将一个子模块从一个目录移动到另一个子目录，例如:"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 repos包含在顶级存储库.git目录中。所有阳离子都来自顶部存储库:

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

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

“[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 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。

[更新: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"