Git子模块为空怎么办：按主仓库记录初始化依赖

克隆项目后依赖目录为空，可能使用了Git子模块。本文说明如何初始化和核对固定提交，避免意外更新到上游最新版。

有些项目把另一份仓库作为子模块保存。主仓库记录的是子模块所在路径和特定提交，普通克隆后目录可能尚未填充。此时直接复制网上的最新文件，会破坏项目原有版本关系。

操作步骤

先查看.gitmodules和git submodule status，确认仓库确实使用子模块。保存子模块里的本地修改后，执行git submodule update --init --recursive，获取主仓库要求的版本。如果失败，分别检查子模块地址、权限和被记录提交是否可访问，而不是立刻改成公开镜像。

怎样确认处理正确

完成后核对状态与主仓库预期提交，并执行项目构建。默认更新与--remote的目的不同：后者可能跟随远程分支，不适合在不了解依赖变更时随意使用。CI也应显式处理子模块。提交依赖升级时同时记录新指针与兼容性结果，让其他人克隆后能够重现同一套代码；目录有文件并不意味着版本已经正确。

参考资料

资料核对日期：2026年10月28日。以下为官方资料综合整理与操作建议，不代表已经对读者的环境完成实测。

Git子模块命令

GitHub克隆说明