子模块是主仓库中指向特定提交的独立仓库，VS Code 可显示其状态但需命令行配合操作。首次克隆应使用 git clone --recurse-submodules 或后续执行 git submodule update --init --recursive 以拉取内容。子模块更新需进入目录手动 git pull 或用 git submodule update --remote 同步远程，默认分支变更后需在主项目 commit 新哈希。添加子模块用 git submodule add <url> <path>，移除时依次执行 deinit、删除 .git/modules 路径并 git rm，最后提交主仓库。VS Code 提供可视化支持，但关键操作建议结合命令行确保准确性。
在 VS Code 中处理 Git 子模块（Submodules）时，结合图形界面与命令行操作可以提升效率并减少错误。关键在于理解子模块的机制，并遵循清晰的工作流程。
理解子模块的基本行为
Git 子模块是嵌套在主仓库中的独立 Git 仓库，它们指向特定提交而非分支（默认）。VS Code 的源代码管理视图能显示子模块状态，但不会自动递归处理其内部变更。
- 子模块路径在主仓库中显示为“已修改”，实际内容是子模块的最新提交哈希
- 进入子模块目录后，需单独进行 commit、push 和 pull 操作
- VS Code 会为每个子模块打开独立的 SCM 视图，可通过侧边栏切换
初始化和克隆包含子模块的项目
首次克隆项目时，必须显式拉取子模块内容。
- 使用命令 git clone --recurse-submodules <repo-url> 一次性完成主项目与子模块的克隆
- 若已克隆主项目，运行 git submodule update --init --recursive 初始化并拉取所有子模块
- 在 VS Code 中打开项目后，若子模块为空，可在终端执行上述命令
更新子模块到最新提交
当子模块远程有更新时，需要手动同步。
- 进入子模块目录，在 VS Code 终端运行 git pull origin main（或对应分支）
- 返回主项目目录，commit 子模块路径的变更，这会记录新的提交指针
- 也可使用 git submodule update --remote 快速拉取默认分支最新提交
添加和移除子模块
建议通过命令行操作以确保配置正确。
- 添加：git submodule add <url> <path>，完成后可在 VS Code 查看新目录状态
- 移除：先 git submodule deinit <path>，再 rm -rf .git/modules/<path>，最后 git rm <path>
- 操作后提交主仓库，VS Code 可正常识别变更
基本上就这些。保持主项目与子模块的提交意图清晰，避免意外提交子模块的未追踪变更。VS Code 提供了良好的可视化支持，但关键操作仍推荐配合 Git 命令使用，确保行为可控。
