Git子模块：如何关联本地开发副本实现实时同步？

方案一：将子模块关联到本地仓库副本 #

这种方式让子模块直接拉取本地库的变更，同步步骤简单直接：

• 先在本地单独克隆一份公开库的副本，比如路径为~/my-public-lib
• 进入项目A的子模块目录（例如projectA/submodules/my-lib），执行命令修改远程地址为本地库路径：

  git remote set-url origin ~/my-public-lib
  

  项目B重复同样操作
• 后续在~/my-public-lib中修改、提交代码后，只需在项目A/B的子模块目录执行git pull，就能同步最新变更
• 需要推送到GitHub远程时，直接在~/my-public-lib执行git push origin main即可，不影响本地同步流程

方案二：用Git Worktree实现多目录实时同步 #

Git Worktree允许一个仓库对应多个工作目录，修改任意目录都会实时同步到其他目录：

• 本地克隆公开库到~/my-public-lib
• 进入项目A根目录，先删除原有子模块目录（确保变更已提交，避免数据丢失）：

  rm -rf submodules/my-lib
  

• 在项目A中创建Worktree链接到本地库的目标分支（以main为例）：

  git worktree add ./submodules/my-lib ~/my-public-lib/main
  

  项目B执行相同命令完成配置
• 现在在~/my-public-lib中修改代码，项目A/B的子模块目录会立刻看到变更，无需额外拉取操作
• 提交变更时，在任意Worktree目录执行提交命令即可，所有关联目录都会同步提交记录

方案三：软链接+Git忽略规避识别问题 #

针对之前软链接被Git识别为typechange的问题，通过忽略配置解决：

• 删除项目A中的子模块目录：

  rm -rf submodules/my-lib
  

• 创建软链接指向本地库：

  ln -s ~/my-public-lib submodules/my-lib
  

• 在项目A的.gitignore中添加submodules/my-lib/，让Git忽略该目录的变更
• 备份项目的.gitmodules文件，开发时注释掉该子模块的配置：

  ;[submodule "submodules/my-lib"]
  ;    path = submodules/my-lib
  ;    url = https://github.com/yourname/my-public-lib.git
  

• 开发完成后，恢复原.gitmodules配置，执行git submodule update --init拉取正式子模块版本

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