首页/开发/Git 与协作速查/git submodule status 查看子模块状态
进阶与大仓实践69 条

git submodule status 查看子模块状态

输出每个子模块当前提交与父仓库记录的差异:前缀 - 表示未初始化、+ 表示提交不一致、U 表示合并冲突,是排查子模块问题的常用入口。

Git 与协作速查开发更新于 2026-10-12
标记空格=一致;-=未初始化;+=提交不同;U=冲突
递归--recursive 逐层展示
摘要git submodule summary 列出子模块内的提交变化

常用示例

常用示例
git submodule status
git submodule status --recursive
git submodule summary
父仓库提交前用 status 确认所有子模块指针都在预期提交,避免把本地实验状态提交进去。

易错点

  • + 前缀说明子模块检出提交与父仓库记录不同,提交父仓库前想清楚要不要更新指针
  • 子模块目录被手工改成普通目录后 status 会异常,需重新 init

数据来源与参考

  • Git 官方文档:git-submodule(status/summary)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌