VSCode编辑器内管理Git子模块的常用命令-VSCode-PHP中文网

vscode中初始化和拉取git子模块需手动执行git submodule init和git submodule update --recursive，否则子模块目录为空或显示为未跟踪文件；图形界面不自动处理子模块操作，所有命令须在集成终端中完成。

vscode编辑器内管理git子模块的常用命令

VSCode 默认不自动处理子模块，git submodule init 和 git submodule update 这两步必须手动执行，否则子模块目录为空或显示为“未跟踪文件”。

常见错误是直接在 VSCode 的源代码管理面板里点击“暂存”或“提交”，结果子模块路径被当成普通文件提交（状态显示为 160000 commit），但实际内容没拉下来。

先在集成终端中运行 git submodule init，初始化 .gitmodules 中定义的子模块配置
再运行 git submodule update --recursive，拉取子模块代码（含嵌套子模块）
如果子模块使用 SSH 地址但本地没配密钥，会卡在权限拒绝，此时要检查 git config --get-regexp submodule 是否指向正确 URL

子模块本身是一个独立仓库，VSCode 编辑器内打开子模块目录时，左下角状态栏会切换成该子模块的分支名（比如 main），而不是父仓库的分支。这意味着你得像操作普通项目一样，在子模块目录里完成完整 Git 流程。

batch-git-url-replace

批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。

下载

进入子模块目录（例如 cd libs/my-sdk），用 VSCode 重新打开该子模块文件夹，才能触发正确的 Git 状态识别
在子模块内做修改 → git add → git commit → git push，这一步不能跳过
回到父仓库根目录，VSCode 源代码管理面板会把子模块路径标为“已修改”，此时需运行 git add libs/my-sdk 提交的是子模块的新 commit hash，不是文件内容

VSCode 的源代码管理视图能识别子模块变更（显示为绿色/黄色图标），但所有操作按钮（✔️ 提交、↑ 推送、↓ 拉取）只作用于父仓库，**不会自动进入子模块执行对应命令**。

这个命令会自动拉取子模块远程 master（或指定分支）的最新 commit，并更新父仓库中的引用。但 VSCode 集成终端默认 shell（如 PowerShell）可能不兼容某些 Git 内部调用，尤其在 Windows 上。

推荐始终用 git bash 终端（而非 PowerShell 或 CMD）执行子模块命令，避免路径分隔符或权限问题
若子模块配置了 branch = main，但远程已改名或删除该分支，--remote 会失败并卡住，需手动进子模块目录检查 git remote show origin
VSCode 不会自动刷新子模块的 commit hash 显示，执行完 update --remote 后需手动点击源代码管理面板右上角刷新按钮

子模块最易被忽略的点：父仓库提交的只是子模块的 commit ID，不是它的内容；每次 clone 新仓库后，必须显式运行 git submodule update --init --recursive，否则所有子模块目录都是空的。