GitKraken切换含子模块分支时内容异常问题求助

问题场景 #

仓库分支结构如下：

parent-repo (branch master)
.
├── test.txt
└── README.md

parent-repo (branch develop)
.
├── .gitmodules
├── test.txt
├── README.md
└── child-repo
    └── README.md

从develop分支切换到master分支时，Shell、VSCode、SourceTree等工具均能正常切换（子模块目录child-repo会被自动清理），但使用GitKraken操作时，child-repo的内容会被保留在master分支中，且不会生成.gitmodules文件。
核心现象：当分支A比分支B包含更多子模块时，切换到分支B后，分支A的子模块内容会被意外保留。

原因分析 #

• GitKraken的子模块处理逻辑与原生Git存在差异：原生Git切换分支时，会自动识别并清理目标分支中未追踪的子模块目录；但GitKraken默认可能未触发该清理机制，或误将已初始化的子模块目录判定为需要保留的工作区内容。
• 子模块处于已初始化状态时，GitKraken不会将其视为未追踪文件，因此切换分支后不会自动删除。

解决方法 #

• 临时应急方案：切换分支前，在GitKraken中对相关子模块执行取消初始化操作，或在终端执行命令：

  git submodule deinit -f child-repo
  

  完成后再切换分支即可避免内容残留。
• 调整GitKraken配置：
  • 打开GitKraken的「Settings」面板，找到Git配置区域，开启「切换分支时自动清理未追踪文件」或「子模块自动同步」相关选项。
  • 切换分支时，勾选「Clean Workspace」（清理工作区）选项，强制同步工作区与目标分支的文件结构。
• 事后补救方案：若已出现内容残留，可在终端执行原生Git命令清理未追踪目录：

  git clean -fd
  

内容的提问来源于stack exchange，提问作者kmzx