git submodule update 默认不拉取远程最新代码，仅检出父仓库记录的提交；需用 --remote 参数配合 --merge 或 --checkout 才能更新至远程最新，且更新后须提交父仓库以保存新 commit ID。

在 Git 中，git submodule update 本身不会自动拉取远程最新代码，它只是把子模块检出到父仓库记录的提交（commit）上。要真正更新子模块的代码到远程最新版，需要配合 --remote 参数或其他明确操作。

理解子模块的“记录提交”机制

父仓库只保存子模块当前指向的某个具体 commit ID（比如 abc1234），并不跟踪子模块的分支或远程最新状态。所以直接运行：

git submodule update

只是让子模块工作目录回到那个已记录的 commit，不会联网、不会获取新提交。

更新子模块到远程分支最新提交（推荐方式）

使用 --remote 参数，Git 会先进入每个子模块，执行类似 git fetch origin && git merge origin/HEAD 的操作（默认基于子模块 .gitmodules 中配置的 branch，或当前 submodule HEAD 所在分支）：

git submodule update --remote

如果想指定分支（比如强制更新到 main）：

Credit Risk Manager Digital Employee

覆盖行业规则生成、大额风险暴露管理、信贷政策分析、风险协作、信息提取、贷后监控预警、贷后管理、VLM验证全流程，助力银行信用风险管理人员实现风险闭环管理。

下载

git submodule update --remote --merge --checkout -b main

常用组合说明：

• --remote：从子模块远程仓库拉取更新
• --merge：将拉取到的最新提交合并进当前子模块分支（保持分支历史）
• --checkout：直接检出远程最新提交（不保留本地分支，更干净）

更新后别忘了提交父仓库的变更

子模块更新后，它的新 commit ID 会变成“未暂存变更”。你需要手动提交这个变化，否则其他人 clone 父仓库时仍会得到旧版本：

git add path/to/submodule<br>git commit -m "submodule: update to latest on main"

这一步非常重要——父仓库的提交才是子模块“新版本”的正式记录。

常见问题与补充技巧

如果遇到子模块未初始化或路径异常：

• 首次使用前需先 git submodule init（读取 .gitmodules 配置）
• 再运行 git submodule update --init --recursive（含嵌套子模块）
• 想批量更新所有子模块并自动提交父仓库？可用脚本辅助，但建议人工确认后再提交，避免意外升级破坏兼容性