如何为Git子模块指定并固定特定提交版本？

你尝试在.gitmodules中添加commit字段锁定子模块版本的方式不可行，Git不会识别该自定义配置项。但你想要的「子模块默认固定在指定提交、除非主动修改父仓库记录的子模块版本否则不会变动」的效果，是Git子模块的原生默认行为，不需要额外修改配置文件实现。

实现原理 #

Git不会从.gitmodules读取子模块的固定版本信息，子模块的提交哈希是作为特殊的树条目直接记录在父仓库的提交历史中的：父仓库不会存储子模块的完整文件内容，只会存储子模块的远端地址，以及当前绑定的子模块提交哈希值。

具体操作步骤 #

如果你已经添加过子模块，按以下步骤操作即可锁定版本：

• 进入本地的子模块目录，检出到你需要的兼容版本提交：

cd path/to/my/submodule
git checkout hash_of_the_commit_where_submodule_is_compatible

• 回到父仓库根目录，将子模块的版本变更提交到父仓库并推送：

cd ../../..
git add path/to/my/submodule
git commit -m "chore: lock submodule to compatible commit"
git push

生效后的默认行为 #

完成上述提交推送后，所有协作者的操作都会完全符合你的预期：

• 使用git clone --recurse-submodules克隆父仓库时，子模块会自动检出你绑定的指定提交，不会拉取对应分支的最新提交
• 协作者在父仓库执行git pull拉取最新代码后，执行git submodule init、git submodule update（含--recursive参数）时，子模块会自动同步到父仓库记录的绑定提交，不会自动升级版本
• 只有当协作者主动进入子模块切换到其他提交、回到父仓库提交子模块的版本变更并推送到父仓库远端后，其他用户拉取父仓库更新才会同步到新的子模块版本，否则子模块版本永远保持在你最初锁定的提交上

注意事项 #

• 你当前.gitmodules中配置的branch = master项，仅在主动执行git submodule update --remote命令时才会生效，该命令会主动拉取配置分支的最新提交。只要协作者不主动执行该命令，这项配置完全不会影响子模块的版本锁定逻辑。如果你不需要主动跟踪子模块的分支更新，可以直接删除该配置项，避免误操作。
• 不要在.gitmodules中添加自定义的commit字段，Git会直接忽略这类未定义的配置项，既起不到锁定版本的作用，还会误导其他阅读配置的协作者。

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