git-submodule

初始化、更新或检查子模块。

概要

git submodule [--quiet] [--cached]
git submodule [--quiet] add [<options>] [--] <repository> [<path>]
git submodule [--quiet] status [--cached] [--recursive] [--] [<path>...]
git submodule [--quiet] init [--] [<path>...]
git submodule [--quiet] deinit [-f|--force] (--all|[--] <path>...)
git submodule [--quiet] update [<options>] [--] [<path>...]
git submodule [--quiet] set-branch [<options>] [--] <path>
git submodule [--quiet] set-url [--] <path> <newurl>
git submodule [--quiet] summary [<options>] [--] [<path>...]
git submodule [--quiet] foreach [--recursive] <command>
git submodule [--quiet] sync [--recursive] [--] [<path>...]
git submodule [--quiet] absorbgitdirs [--] [<path>...]

描述

检查、更新和管理子模块。

有关子模块的更多信息，请参阅 gitsubmodules(7)。

命令

不带参数时，显示现有子模块的状态。有几个子命令可用于对子模块执行操作。

• add：将给定仓库作为子模块添加到给定路径。
• status：显示子模块的状态。
• init：初始化子模块。
• deinit：取消初始化子模块。
• update：更新子模块。
• set-branch：设置子模块的分支。
• set-url：设置子模块的 URL。
• summary：显示子模块的摘要。
• foreach：在每个子模块中运行命令。
• sync：同步子模块的 URL。
• absorbgitdirs：将子模块的 .git 目录吸收到超级项目中。

选项

• --quiet：安静模式。
• --cached：使用缓存的更改。
• --recursive：递归处理子模块。
• -f, --force：强制执行操作。
• -b, --branch：指定分支。
• --name：指定子模块名称。
• --reference：指定参考仓库。
• --ref-format：指定引用存储格式。
• --depth：指定克隆深度。

另请参阅

gitsubmodules(7)

Git

git 套件的一部分