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 中修改子模块后如何提交
子模块本身是一个独立仓库，VSCode 编辑器内打开子模块目录时，左下角状态栏会切换成该子模块的分支名（比如 main），而不是父仓库的分支。这意味着你得像操作普通项目一样，在子模块目录里完成完整 Git 流程。
GitHub Actions Runtime Regression Audit
下载
对比基线与当前 GitHub Actions 运行导出，在 CI 成本和交付周期激增前及时发现工作流或作业运行时性能退化。
- 进入子模块目录（例如
cd libs/my-sdk），用 VSCode 重新打开该子模块文件夹，才能触发正确的 Git 状态识别 - 在子模块内做修改 →
git add→git commit→git push，这一步不能跳过 - 回到父仓库根目录，VSCode 源代码管理面板会把子模块路径标为“已修改”，此时需运行
git add libs/my-sdk提交的是子模块的新 commit hash，不是文件内容
VSCode 图形界面对子模块的支持边界在哪
VSCode 的源代码管理视图能识别子模块变更（显示为绿色/黄色图标），但所有操作按钮（✔️ 提交、↑ 推送、↓ 拉取）只作用于父仓库，**不会自动进入子模块执行对应命令**。
- 点击“同步更改”按钮，只会对父仓库执行
git pull或git push，子模块更新需单独处理 - 右键子模块目录 → “Git: Revert Changes” 无效，因为子模块是 commit 引用，不是文件差异
- 冲突提示仅出现在父仓库层面（比如两个 PR 修改了同一个子模块 hash），VSCode 不会帮你合并子模块内部的代码冲突
为什么 git submodule update --remote 在 VSCode 终端里容易出错
这个命令会自动拉取子模块远程 master（或指定分支）的最新 commit，并更新父仓库中的引用。但 VSCode 集成终端默认 shell（如 PowerShell）可能不兼容某些 Git 内部调用，尤其在 Windows 上。
- 推荐始终用
git bash终端（而非 PowerShell 或 CMD）执行子模块命令，避免路径分隔符或权限问题 - 若子模块配置了
branch = main，但远程已改名或删除该分支，--remote会失败并卡住，需手动进子模块目录检查git remote show origin - VSCode 不会自动刷新子模块的 commit hash 显示，执行完
update --remote后需手动点击源代码管理面板右上角刷新按钮
git submodule update --init --recursive，否则所有子模块目录都是空的。 
