如何仅对GitHub仓库中的指定子目录进行开发与版本控制

你之前用git filter-branch/git filter-repo操作会覆盖原仓库文件，本质是工具选型错了：这两个工具的作用是重写、裁剪整个仓库的提交历史，输出的是仅包含目标目录的独立仓库，推送到原fork仓库自然会覆盖根目录下的安装文件，完全不适用于「保留原仓库其他文件、仅单独管理local目录版本」的场景。

根据你的开发需求，可以从以下三个方案里选，优先推荐前两个支持远端版本备份的方案：

方案1：独立仓库 + 子模块（适合长期维护、计划向上游提PR的场景） #

这是最符合git设计规范的目录拆分方案，操作步骤：

• 新建一个空的GitHub仓库，专门用于存放local目录的所有代码与提交记录
• 将原公开仓库完整fork到你的个人账号下，克隆到本地
• 进入本地克隆的仓库目录，执行git rm -r --cached local清除git对原local目录的跟踪缓存，删除本地的local目录
• 执行git submodule add 你刚新建的独立仓库地址 local，将独立仓库作为子模块挂载到原local路径
• 将根目录下的安装文件变更提交，推送到你的fork仓库即可
  后续所有针对local目录的开发、提交、版本回溯都在local目录内的子模块仓库操作，和你直接修改原local目录的本地测试体验完全一致，且不会和根目录的安装文件版本产生冲突。

注意：如果后续要向上游原仓库提交PR，可以直接把local目录的改动打包成普通补丁提交，不需要带上子模块配置；如果上游维护者认可拆分方案，再同步提交子模块的关联配置即可。

方案2：git subtree 子树（适合不想给仓库使用者增加额外操作的场景） #

如果你不想引入子模块（普通用户克隆带子模块的仓库需要加额外参数才能拉全内容），可以用子树方案实现版本隔离：

• 同样先新建一个专门存储local目录代码的独立空仓库
• 本地完整fork并克隆原仓库后，执行git subtree add --prefix=local 你的独立仓库地址 main --squash，将独立仓库与local路径做关联
• 后续local目录的改动如果要同步到独立仓库做版本管理，执行git subtree push --prefix=local 你的独立仓库地址 main即可；根目录安装文件的改动正常在主仓库提交推送，两边历史完全隔离，不会互相覆盖。
  这个方案的优势是其他用户克隆你的fork仓库时，不需要额外操作就能拿到完整的local目录代码，使用门槛更低，仅有的缺点是版本同步的命令比子模块稍长。

方案3：git worktree 本地挂载（适合仅本地临时测试、不需要远端备份的场景） #

如果你只是临时做本地开发调试，不需要把local目录的改动推送到远端备份，甚至不需要新建远端仓库：

• 本地新建一个独立文件夹作为local目录的开发仓库，执行git init初始化，把原仓库local目录下的所有文件拷贝进去，正常做提交、版本管理
• 执行git worktree add 你本地安装应用对应的local目录路径 你当前开发的分支名，直接把开发分支的工作树挂载到本地应用的运行目录，改完代码可以直接测试，所有版本记录存在你单独创建的本地仓库里，完全不碰原fork仓库的文件结构，自然不会出现覆盖安装文件的问题。

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