Git自定义提交最佳实践：OpenCV子模块修改后更新保留方案

当你把OpenCV作为Git子模块固定到特定提交，且做了不会被上游合并的自定义修改，同时需要同步上游后续提交时，有两种可靠的实践方案：

方案一：补丁管理（适合小范围临时修改） #

• 生成自定义补丁：进入OpenCV子模块目录，执行git diff > ../../opencv-custom-fix.patch（路径根据主项目结构调整），将补丁文件纳入主项目的版本控制，方便团队共享。
• 更新子模块到上游新提交：在子模块目录下，执行git fetch origin && git checkout <目标上游提交哈希>，同步到最新的上游版本。
• 应用自定义补丁：回到主项目，进入子模块目录执行git apply ../../opencv-custom-fix.patch，若出现冲突，手动修改冲突文件后，执行git add . && git commit提交子模块的新状态，最后在主项目中提交子模块的引用更新。

方案二：自定义分支维护（适合长期/多修改场景） #

• 创建自定义分支：进入OpenCV子模块目录，从当前固定的上游提交创建专属分支，比如git checkout -b my-opencv-custom，将你的自定义修改提交到这个分支。
• 同步上游更新：
  1. 切换到上游主分支（例如main）：git checkout main
  2. 拉取上游最新代码：git fetch origin && git merge origin/main
  3. 切回自定义分支做变基：git checkout my-opencv-custom && git rebase main
  4. 手动解决变基过程中的冲突，完成后提交子模块的状态。
• 更新主项目引用：在主项目中提交子模块指向自定义分支的最新状态，确保其他克隆项目的成员能同步到你的修改和上游更新。

注意事项 #

• 无论采用哪种方案，主项目中子模块的引用状态都需要提交，否则其他成员克隆或拉取后无法获取正确的子模块版本。
• 分支方案中，建议定期同步上游，避免间隔过久导致变基冲突过多；若不想维护线性提交记录，也可以用git merge main代替git rebase main，但会产生合并提交。

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