如何将Git本地克隆共享为多项目submodule并简化VS Code源控制显示？

一、用本地克隆作为多项目共享的Submodule #

要实现修改一次同步所有项目，核心是让所有项目的Submodule指向同一个本地Git克隆，而非各自单独拉取：

1. 单独克隆共享Submodule仓库到本地固定位置

   git clone https://github.com/你的用户名/共享仓库名.git ~/shared-submodules/共享仓库名
   

   比如把共享仓库存在~/shared-submodules/common-lib，方便后续统一管理。

2. 让现有项目指向这个本地克隆
   对每个需要该Submodule的项目，修改本地Git配置，将Submodule的远程地址替换为本地路径：

   cd /path/to/你的项目1
   git config submodule.共享仓库名.url ~/shared-submodules/共享仓库名
   

   重复此操作给所有相关项目。这样所有项目的Submodule都会读取同一个本地目录的代码，远程仓库的.gitmodules文件仍保留原远程URL，不会影响团队协作。

二、让VS Code源代码控制只显示一个Submodule #

按上面的配置后，你只需要在共享的本地克隆仓库里开发：

• 直接在VS Code中打开~/shared-submodules/共享仓库名，所有修改操作都在这里进行，源代码控制概览里只会显示这个仓库的变更。
• 修改完成后，在共享仓库里提交并推送到远程：

  git add .
  git commit -m "修复XX功能/新增XX特性"
  git push origin main
  

三、同步所有项目到最新Submodule版本 #

因为所有项目的Submodule都指向同一个本地克隆，修改后项目目录里的Submodule代码会自动更新，你只需要在每个项目里提交版本更新即可：

cd /path/to/你的项目1
git add ./Submodule目录路径
git commit -m "更新共享Submodule到最新版本"

或者在VS Code的源代码控制面板里，直接对Submodule执行"提交"操作即可，无需逐个拉取。

内容的提问来源于stack exchange，提问作者tmol