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 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），避免全量拉取耗时或干扰其他模块。

从 Git 仓库历史中彻底删除文件

|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载

直接进入子模块目录操作更可控：

• cd vendor/react
• git 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 时拿到的仍是旧版本。