git pull 不会自动更新子模块，因为它只拉取主仓库提交，不操作子模块；子模块需用 git submodule update --remote 等命令显式更新，并提交父仓库中变更的 commit ID。
git pull 为什么不会自动更新子模块
因为 git pull 默认只拉取当前仓库的提交，完全不触碰子模块目录。子模块在 Git 中是“被引用的独立仓库”，它的 commit ID 被父仓库以文件形式记录在 .gitmodules 和 git index 中——pull 不会主动去子模块里执行 git pull，也不会自动更新那个 commit ID。
常见错误现象：git status 显示子模块目录“modified”，但 git diff 只显示类似 Subproject commit abc123... → def456...，IDE 里子模块内容没变，实际已落后远程几十个提交。
- 子模块未配置
branch字段时，git submodule update --remote会报错或静默失败 - 用
git pull --recurse-submodules前，必须确保本地已初始化子模块（即运行过git submodule init和git submodule update） - 如果子模块本身有未提交的本地修改，
submodule update会拒绝覆盖，需先git checkout --force或手动清理
同步子模块到其远程分支最新提交
这是最常用、也最符合协作预期的做法：让子模块始终跟踪它自己远端 main（或 master）分支的 tip。
前提是子模块已在 .gitmodules 中声明了要跟踪的分支，例如：
[submodule "libs/utils"]
path = libs/utils
url = https://git.example.com/utils.git
branch = main然后执行：
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
-
git submodule update --remote --recursive：拉取所有子模块的branch对应远程分支最新提交，并更新父仓库中记录的 commit ID -
git submodule update --remote --merge：同上，但会在子模块内执行git merge（适合你希望保留子模块本地变更并合入上游） -
git add .+git commit -m "update submodules"+git push：必须做，否则其他协作者拉不到这个更新
只更新某个特定子模块
当项目含多个子模块，但只想动其中一个（比如只更新 vendor/react），避免全量拉取耗时或干扰其他模块。
直接进入子模块目录操作更可控：
cd vendor/reactgit fetch origin-
git merge origin/main（或git checkout origin/main强制切换） -
cd ..返回父仓库根目录 -
git status会显示vendor/react已 modified（commit ID 变了） -
git add vendor/react提交该变更
注意：不要在子模块里 git push，除非你有权限且明确要推送到子模块自己的远程仓库。
子模块 commit ID 锁死时怎么强制更新
有些项目故意把子模块固定在某个 release commit（不设 branch），这时 --remote 无效。你得手动指定目标 commit：
-
git submodule foreach --recursive 'git fetch origin'：先统一 fetch 所有子模块远程 -
git submodule set-branch --branch main -- src/thirdparty/openssl：为某个子模块显式设置跟踪分支（会改.gitmodules） - 或跳过配置，直接
cd src/thirdparty/openssl && git checkout origin/main && cd -，再git add src/thirdparty/openssl
最容易被忽略的一点：子模块更新后，父仓库的 commit ID 变更属于「代码变更」，必须 git add 并 commit，否则 git push 不会把这次同步发出去——别人 git clone --recurse-submodules 时拿到的仍是旧版本。
