添加、更新和删除 Git 子模块
简介
Git 是一个流行的源代码管理版本控制系统。Git 的强大功能之一是能够将外部代码库合并为项目中的子模块。这允许您在自己的项目中重用其他代码库的代码，并独立跟踪父项目和子模块的更改。
在本文中，我们将探讨如何添加、更新和删除 Git 子模块。我们将介绍每个操作所需的基本命令和选项，并提供示例以帮助您更好地理解操作过程。
添加 Git 子模块
添加 Git 子模块是一个简单的过程。要向项目添加新的子模块，您可以使用 git submodule add 命令。此命令接受两个参数:子模块仓库的 URL 以及子模块在项目中的添加路径。
例如，假设我们想在项目中将"jquery"仓库添加为子模块。我们将使用以下命令 -
git submodule add https://github.com/jquery/jquery.git path/to/submodule
此命令会将"jquery"仓库克隆到项目中的"path/to/submodule"目录中，并将其添加为子模块。
更新 Git 子模块
将子模块添加到项目后，您可能需要更新它以获取最新更改。要更新子模块，可以使用 git submodule update 命令。
此命令提供了几个选项来控制更新的执行方式。默认行为是将子模块更新到父项目 .gitmodules 文件中指定的提交。但是，您也可以将子模块更新到最新提交，或者更新到特定分支或提交哈希值。
例如，假设我们要将"jquery"子模块更新到最新提交。我们将使用以下命令 -
git submodule update --remote path/to/submodule
此命令将从"jquery"代码库中获取最新更改，并将项目中的子模块更新到最新提交。
删除 Git 子模块
如果您不再需要项目中的某个子模块，可以使用 git submodule deinit 和 git rm 命令将其删除。
git submodule deinit 命令将从项目的 .git/config 文件中删除子模块。这会告诉 Git 停止跟踪子模块的更改。但是，子模块的文件仍然存在于项目目录中。
要删除子模块的文件，可以使用 git rm 命令。此命令会从项目目录以及 Git 索引中删除子模块的文件。
例如，假设我们要从项目中删除"jquery"子模块。我们将使用以下命令 -
git submodule deinit path/to/submodule git rm path/to/submodule
这些命令将从项目的 .git/config 文件中删除"jquery"子模块，并从项目目录中删除其文件。
高级子模块管理
除了添加、更新和删除 Git 子模块的基本操作外，您还可以使用一些高级技术来更有效地管理子模块。
递归子模块初始化和更新
如果您的项目包含多个子模块，则单独初始化和更新它们可能会很麻烦。幸运的是，Git 提供了一个递归选项，允许您一次性初始化和更新所有子模块。
要以递归方式初始化项目中的所有子模块，您可以使用 git submodule update --init 命令。此命令将初始化所有尚未初始化的子模块。
要以递归方式更新项目中的所有子模块，您可以使用 git submodule update --recursive 命令。此命令会将所有子模块更新到父项目 .gitmodules 文件中指定的提交。
自定义子模块分支
默认情况下，子模块会更新到父项目 .gitmodules 文件中指定的提交。但是，您也可以为每个子模块指定自定义分支或提交哈希值。
要为子模块指定自定义分支，您可以将 --branch 选项与 git submodule add 命令结合使用。例如 -
git submodule add --branch my-branch https://github.com/my-repo/my-submodule.git path/to/submodule
此命令将"my-submodule"仓库添加为子模块，并检出"my-branch"分支。
要将子模块更新到自定义分支或提交哈希，可以使用 git submodule update --remote --merge 命令，并附带 --remote 和 --merge 选项。例如:
git submodule update --remote --merge path/to/submodule
此命令将从"my-submodule"仓库获取最新更改，并将其合并到当前分支。
子模块存储
更新子模块时，您在子模块中所做的任何本地更改都将丢失。为了避免丢失这些更改，您可以在更新子模块之前使用 Git 的存储功能保存更改。
要存储子模块中的更改，您可以将 git submodule foreach 命令与 git stash 命令结合使用。例如:
git submodule foreach 'git stash'
此命令将存储项目中所有子模块中的更改。
要在更新子模块后应用存储的更改，您可以将 git submodule foreach 命令与 git stash apply 命令结合使用。例如 -
git submodule foreach 'git stash apply'
此命令将应用项目中所有子模块中存储的更改。
Git 子模块问题故障排除
虽然 Git 子模块是管理代码依赖关系的强大工具，但当出现问题时，它们也可能令人沮丧。以下是一些常见问题及其解决方案 -
问题:子模块未初始化
克隆包含子模块的 Git 仓库时，默认情况下不会初始化子模块。您需要运行 git submodule update 命令来初始化它们。
解决方案 − 运行 git submodule update --init
问题:子模块文件丢失
有时，初始化子模块后，子模块的文件可能会丢失。如果子模块的文件未正确包含在初始克隆中，则可能会发生这种情况。
解决方案 - 运行 git submodule update --init --recursive
此命令将更新所有子模块，包括在初始克隆期间未正确初始化的子模块。
问题:子模块分支不同步
如果子模块的分支与父存储库不同步，则在更新子模块时可能会遇到冲突。
解决方案 - 更新子模块分支
要更新子模块分支，可以使用带有 --rebase 选项的 git submodule update --remote 命令。此命令将从子模块仓库获取最新更改，并将更改变基到当前分支。
问题:子模块未更新
有时，使用 git submodule update 命令更新子模块可能不会产生预期的更改。
解决方案 - 检查子模块分支和提交
确保子模块位于正确的分支和提交。您可以使用 git submodule status 命令检查子模块的分支和提交。如果子模块不在预期的分支或提交上，您可以使用带有 --merge 选项的 git submodule update --remote 命令将子模块更新到最新提交。
结论
在本文中，我们探讨了如何添加、更新和删除 Git 子模块。子模块是 Git 的一项强大功能，允许您在自己的项目中重用其他仓库的代码。通过了解如何使用子模块，您可以改进代码的组织性和可维护性。
请记住使用 git submodule add、git submodule update、git submodule deinit 和 git rm 命令来有效地管理子模块。请记住，子模块可能很复杂，因此花时间了解它们的工作原理以及如何正确使用它们非常重要。
相关文章
有用资源
linux 参考教程 - 该教程包含有关 linux 的更多信息:https://www.cainiaomax.com/linux/
