Visual Studio 2017中Git子模块提交报错问题咨询

兄弟，我碰到过不少VS2017+Git子模块的坑，这个fatal: unexpected sequence in commit output错误多半是这几个原因，还有可能是你对子模块的提交逻辑理解错了——

• VS2017自带Git版本太老：VS2017默认集成的Git版本大多是2.x早期版本，而Git对子模块的提交输出处理逻辑在后续版本里有过修复。老版本的Git在解析子模块提交时，会对一些新的输出格式“认不出”，直接抛出序列错误。
• 子模块配置或本地状态损坏：如果.gitmodules文件里的子模块路径有特殊字符、层级错误，或者子模块本地的.git目录损坏/锁死，VS的Git插件在读取状态时会混乱，提交时就会触发错误。
• VS Git插件的缓存bug：VS2017的Git状态缓存经常抽风——比如子模块已经提交了，但VS还显示未变更；或者本地状态和远程不一致，插件没同步过来。这种缓存错位会导致提交时解析输出出错。

很多人会把子模块当成主仓库的“子文件夹”，以为可以和主仓库代码一起提交，但实际上子模块是完全独立的Git仓库，主仓库只存了子模块的某个提交哈希值。正确的提交流程应该是：

1. 进入子模块目录，先完成子模块的变更提交：git add . → git commit -m "子模块更新说明" → git push
2. 回到主仓库，此时主仓库会检测到子模块的引用更新，再提交主仓库的变更。

如果跳过第一步，直接在主仓库里提交子模块的“变更”，VS的Git工具根本处理不了这种不完整的状态，大概率会报错——这也是很多人踩的坑。

• 改用命令行操作：绕开VS的Git插件，直接用原生Git命令完成子模块和主仓库的提交，能完美规避VS的兼容性问题。
• 清理Git锁文件：如果是状态锁死导致的，关闭VS，删除主仓库和子模块目录下的.git/index.lock文件，再重启VS刷新状态。
• 升级VS的Git组件：在VS的「工具→选项→源代码管理→Git全局设置」里，尝试更新Git到较新的版本（不过VS2017对新版本Git支持有限，效果不一定完美）。

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