如何在多个Git仓库之间共享指定的文件夹或文件

下面是不同场景下的主流实现方案，你可以根据自己的使用需求选择：

方案1：git sparse-checkout + git submodule 组合 #

最接近SVN externals的使用体验，适合需要跟踪上游仓库更新、仅只读使用共享内容的场景
操作步骤：

• 先在主仓库添加上游仓库为子模块：git submodule add <上游仓库地址> <本地存放路径>
• 进入子模块对应的本地目录，开启稀疏检出功能：git sparse-checkout init --cone
• 配置需要拉取的指定目录/文件：git sparse-checkout set <目标目录1> <目标目录2>
• 执行拉取操作即可仅拿到指定内容：git pull
  特点：
• 可以直接跟踪上游的提交记录，需要更新时仅需在子模块目录执行git pull就能同步最新内容
• 不会额外增加主仓库的存储体积，子模块仅记录上游对应版本的commit哈希
• 劣势是操作门槛略高，团队成员需要掌握submodule的基础操作逻辑，避免误提交子模块的修改；如果需要修改共享内容，要单独向上游仓库提交，不能直接在主仓库修改后同步

方案2：git subtree #

适合需要在主仓库内修改共享内容、同时还要和上游双向同步的场景
操作步骤：

• 先给主仓库添加上游仓库为远程源：git remote add <上游自定义别名> <上游仓库地址>
• 首次拉取指定目录到本地执行：git subtree add --prefix=<本地存放路径> <上游自定义别名> <上游分支名> --squash
• 后续同步上游更新执行：git subtree pull --prefix=<本地存放路径> <上游自定义别名> <上游分支名> --squash
• 如果需要把主仓库内对共享内容的修改同步回上游，执行：git subtree push --prefix=<本地存放路径> <上游自定义别名> <上游分支名>
  特点：
• 对团队其他成员完全透明，拉取主仓库代码时会直接拿到所有共享文件，不需要执行额外操作
• 支持直接在主仓库内修改共享内容，双向同步逻辑完整
• 劣势是操作命令冗长容易写错，且共享内容的提交历史会合并到主仓库，增加主仓库的提交记录量

方案3：自定义同步脚本 #

适合共享内容更新频率极低、不需要跟踪上游提交历史的轻量场景
操作思路：

• 编写简单的shell/powershell脚本，逻辑为临时克隆上游仓库，将指定的目录/文件复制到主仓库对应位置后删除临时克隆的上游仓库
• 将脚本放到主仓库根目录，需要更新共享内容时直接执行脚本即可
  特点：
• 操作成本最低，不需要团队成员掌握Git高级用法
• 灵活度极高，可以根据需求自定义筛选逻辑
• 劣势是无法自动跟踪上游更新，需要手动执行脚本同步，也没有明确的版本关联，不容易确定当前使用的共享内容对应上游的版本

场景选择建议：

• 只读使用、需要跟踪更新：优先选 sparse-checkout + submodule 方案
• 需要双向修改同步：优先选 git subtree 方案
• 更新频率极低、追求简单：优先选 自定义同步脚本 方案

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