Git Submodule 全流程使用指南
内容提要
Git Submodule 是 Git 中用于办理子项目的强壮功用。它允许将一个 Git 库房作为另一个 Git 库房的子模块进行办理，使项目结构更加明晰，代码保护更加方便。本攻略具体解说了 Submodule 的创立、规划、更新、兼并全流程的运用进程和操作过程，协助更好地了解和运用 Submodule。
延伸解读
子模块与主项目的版本耦合关系
文章指出，子模块的版本管理需纳入项目整体规划。这意味着主项目并不自动跟踪子模块的最新提交，而是通过子模块指针锁定特定版本。若子模块独立更新，主项目需显式提交新的指针才能同步。这种机制虽保证了构建稳定性，但也要求团队在更新子模块后及时在主项目中提交变更，否则其他成员拉取代码时仍会使用旧版本。
更新子模块的两种路径与适用场景
文章介绍了两种更新方式：使用 git submodule update 可批量或指定更新子模块，适合常规同步；而通过 git fetch 加 git reset --hard 可单独将子模块重置到特定版本，如 v1.0.0。后者更灵活，但会强制覆盖子模块工作区，可能丢失未提交的修改。读者应根据是否需要精确控制版本、是否保留本地改动来选择合适的方法。
子模块冲突的处理流程
当子模块更新引发冲突时，文章建议先运行 git submodule status 查看状态，再用 git submodule foreach git mergetool 逐个处理冲突，最后提交解决结果。这一流程表明，子模块冲突需进入每个子模块内部手动解决，而非在主项目层面直接处理。因此，团队应提前约定子模块的更新频率和分支策略，以减少冲突发生的概率。
删除子模块的注意事项
文章提到删除子模块需依次执行 git submodule deinit 和 git rm -rf。deinit 会取消子模块的初始化，从 .git/config 中移除相关配置；git rm 则删除工作区文件并暂存变更。若只执行其中一步，可能残留配置或目录，导致后续操作异常。删除后还需提交主项目的变更，才能让其他协作者同步移除该子模块。
Q&A
如何创建一个 Git Submodule？
首先初始化主项目库房，然后使用 git submodule add 指令添加子模块，最后提交更改。
Git Submodule 的版本控制是如何管理的？
子模块的版本控制可以通过 git submodule update 指令进行管理，支持更新所有或指定的子模块。
如何更新 Git Submodule？
可以使用 git submodule update --recursive 更新所有子模块，或使用 git submodule update <子模块目录> 更新指定子模块。
在合并子模块时如何处理冲突？
当子模块更新导致冲突时，需要手动处理，使用 git submodule status 和 git submodule foreach git mergetool 来解决。
Git Submodule 的高级用法有哪些？
高级用法包括使用子模块指针指定特定版本、克隆子模块到独立目录和删除子模块。
使用 Git Submodule 时需要注意什么？
需要注意子模块的更新可能导致项目冲突，以及子模块的版本管理需纳入整体规划。
