如何在Git中直接克隆仓库指定子目录并实现双向同步？

我刚好遇到过类似的需求，有两种靠谱的方法可以实现你的目标——把远程库的sample/lib目录直接同步到Project Root/app/lib，同时支持双向的修改推送与拉取，完全避免稀疏检出默认带来的多余根目录问题，具体如下：

方法一：稀疏检出+路径映射（Git 2.25+） #

这种方法适合希望app/lib作为独立Git仓库管理的场景，操作步骤清晰：

1. 定位到目标目录并初始化仓库
   先进入项目的app目录，创建并进入lib子目录，初始化一个新的Git仓库：

   cd Project/Root/app
   mkdir lib && cd lib
   git init
   

2. 关联远程库并配置稀疏检出
   添加你的库仓库作为远程源，然后开启稀疏检出功能，指定将远程的sample/lib目录映射到当前本地目录：

   git remote add library https://your-library-repo-url.git
   git config core.sparseCheckout true
   git sparse-checkout set --prefix=./ sample/lib/
   

   --prefix=./的作用就是把远程sample/lib下的内容直接拉到当前本地目录，不会带上层的sample文件夹。

3. 拉取远程内容
   拉取远程仓库的主分支（比如main），此时lib目录下就会直接出现远程sample/lib里的所有文件：

   git pull library main
   

双向同步操作 #

• 推送本地修改到远程：在app/lib目录下，正常执行Git提交和推送命令即可：

  git add .
  git commit -m "Update lib files from project"
  git push library main
  

• 拉取远程更新：同样在app/lib目录下执行：

  git pull library main
  

方法二：Git Subtree（更适合主仓库统一管理） #

如果你的Project Root本身就是一个Git仓库，想要把app/lib作为主仓库的一部分来管理，git subtree是更省心的选择，它不需要维护多个独立仓库：

1. 添加远程库作为子树
   进入项目根目录，将远程库的sample/lib目录添加为app/lib子树：

   cd Project/Root
   git subtree add --prefix=app/lib https://your-library-repo-url.git main --squash
   

   这里的--squash会把远程的所有提交合并为一个本地提交，避免主仓库的提交历史被远程库的历史打乱，不需要的话可以去掉这个参数。

2. 拉取远程更新
   当远程库的lib目录有更新时，在项目根目录执行以下命令同步到本地：

   git subtree pull --prefix=app/lib https://your-library-repo-url.git main --squash
   

3. 推送本地修改到远程
   修改app/lib下的内容后，先提交到主仓库，再推送到远程库：

   git add app/lib
   git commit -m "Update lib content"
   git subtree push --prefix=app/lib https://your-library-repo-url.git main
   

两种方法对比 #

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