设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
- 2.42.1 → 2.50.1 无变化
-
2.42.0
2023-08-21
- 2.32.1 → 2.41.3 无变更
-
2.32.0
2021-06-06
- 2.30.2 → 2.31.8 无更改
-
2.30.1
2021-02-08
- 2.28.1 → 2.30.0 无变更
-
2.28.0
2020-07-27
- 2.25.1 → 2.27.1 无变化
-
2.25.0
2020-01-13
- 2.24.2 → 2.24.4 无变更
-
2.24.1
2019-12-06
-
2.24.0
2019-11-04
- 2.23.2 → 2.23.4 无变更
-
2.23.1
2019-12-06
-
2.23.0
2019-08-16
- 2.22.3 → 2.22.5 无变更
-
2.22.2
2019-12-06
- 2.22.1 无变更
-
2.22.0
2019-06-07
- 2.21.2 → 2.21.4 无变更
-
2.21.1
2019-12-06
-
2.21.0
2019-02-24
- 2.20.3 → 2.20.5 无变更
-
2.20.2
2019-12-06
- 2.20.1 无变更
-
2.20.0
2018-12-09
- 2.19.4 → 2.19.6 无变更
-
2.19.3
2019-12-06
-
2.19.2
2018-11-21
- 2.19.1 无更改
-
2.19.0
2018-09-10
- 2.18.3 → 2.18.5 无变更
-
2.18.2
2019-12-06
- 2.18.1 无变更
-
2.18.0
2018-06-21
- 2.17.4 → 2.17.6 无变更
-
2.17.3
2019-12-06
- 2.17.1 → 2.17.2 无变更
-
2.17.0
2018-04-02
- 2.16.6 无变更
-
2.15.4
2019-12-06
- 2.14.6 无更改
-
2.13.7
2018-05-22
- 2.11.4 → 2.12.5 无变更
-
2.10.5
2017-09-22
-
2.9.5
2017-07-30
- 2.4.12 → 2.8.6 无变更
-
2.3.10
2015-09-28
- 2.1.4 → 2.2.3 无更改
-
2.0.5
2014-12-17
描述
位于 Git 工作树顶级目录中的 .gitmodules
文件是一个文本文件,其语法符合 git-config[1] 的要求。
该文件包含每个子模块的一个子节,子节的值是子模块的名称。除非使用 git submodule add 命令的 --name
选项进行了自定义,否则该名称将设置为添加子模块的路径。每个子模块节还包含以下必需键:
- submodule.<name>.path
-
定义子模块预期检出位置的路径,该路径相对于 Git 工作树的顶级目录。路径名不得以
/
结尾。所有子模块路径在.gitmodules
文件中必须是唯一的。 - submodule.<name>.url
-
定义可用于克隆子模块仓库的 URL。这可以是准备传递给 git-clone[1] 的绝对 URL,或者(如果以
./
或../
开头)相对于超项目(superproject)源仓库的位置。
此外,还有一些可选键:
- submodule.<name>.update
-
定义指定子模块的默认更新过程,即超项目(superproject)中的
git
submodule
update
命令如何更新子模块。这仅由git
submodule
init
用于初始化同名配置变量。允许的值为 checkout、rebase、merge 或 none,但不允许 !command(出于安全原因)。有关详细信息,请参阅 git-submodule[1] 中 update 命令的说明。 - submodule.<name>.branch
-
用于跟踪上游子模块更新的远程分支名称。如果未指定此选项,则默认为远程
HEAD
。特殊值.
用于指示子模块中的分支名称应与当前仓库中的当前分支名称相同。有关详细信息,请参阅 git-submodule[1] 中--remote
的文档。 - submodule.<name>.fetchRecurseSubmodules
-
此选项可用于控制此子模块的递归获取。如果此选项也存在于超项目(superproject)的
.git/config
中子模块的条目中,则该设置将覆盖.gitmodules
中找到的设置。这两个设置都可以通过在命令行中使用git
fetch
和git
pull
的--
[no-
]recurse-submodules
选项来覆盖。 - submodule.<name>.ignore
-
定义在何种情况下
git
status
和 diff 系列命令会将子模块显示为已修改。支持以下值:如果此选项也存在于超项目(superproject)的
.git/config
中子模块的条目中,则该设置将覆盖.gitmodules
中找到的设置。这两个设置都可以通过在命令行中使用
--ignore-submodules
选项来覆盖。git
submodule
命令不受此设置的影响。 - submodule.<name>.shallow
-
当设置为 true 时,此子模块的克隆将作为浅克隆(历史深度为 1)执行,除非用户明确要求非浅克隆。
注意事项
Git 不允许工作树内的 .gitmodules
文件是符号链接,并且将拒绝检出此类树条目。这使得从索引或树(而不是文件系统)访问文件时的行为保持一致,并有助于 Git 可靠地执行文件内容的安全检查。
示例
考虑以下 .gitmodules
文件:
[submodule "libfoo"] path = include/foo url = git://foo.com/git/lib.git [submodule "libbar"] path = include/bar url = git://bar.com/git/lib.git
这定义了两个子模块:libfoo
和 libbar
。它们预期将被检出到路径 include/foo
和 include/bar
中,并且为这两个子模块都指定了一个可用于克隆子模块的 URL。