Ivan's Blog
Memo

跨项目共享本地 Git 子模块配置

Git

配置现有子模块

  1. 修改子模块 URL

S 是子模块名称。

cd /path/to/parent_repo # 进入父仓库（A/B/C）
git config submodule.S.url /projects/S # 指向你的本地仓库
  1. 强制重新初始化
rm -rf S # 删除旧子模块
git submodule update --init --force
  1. 附加配置（若报错） 如果出现 transport 'file' not allowed：
git config --global protocol.file.allow always

新增子模块

  1. 按常规方式添加子模块（生成远程URL配置）
git submodule add https://github.com/example/S.git S
  1. 修改本地子模块的URL配置（覆盖远程地址）
git config submodule.S.url /projects/S
  1. 初始化子模块（强制使用本地路径）
git submodule update --init --force

关键注意事项

  1. 安全限制 新版 Git 默认禁用本地文件协议克隆，可能需执行步骤3
  2. 作用范围 仅影响本地环境，远程仓库不受影响
  3. 版本跟踪 各父仓库仍需独立提交子模块版本更新