从Monorepo子目录创建独立仓库并保留相关文件与提交记录

嘿，我来帮你搞定从Monorepo里提取单个包成独立仓库，同时只保留相关提交记录的事儿！你提到尝试了git filter-branch --subdirectory-filter，这个方向完全正确，只是命令写法可能有点小问题，我给你捋清楚完整的实操步骤：

步骤1：克隆原仓库的副本（避免破坏原仓库） #

先别直接在原仓库操作，克隆一份副本防止误操作搞坏原历史：

git clone <你的原Monorepo仓库URL> temp-extracted-repo
cd temp-extracted-repo

步骤2：用filter-branch过滤出目标目录的提交 #

你之前的命令多了git log部分，这是错误的。正确的filter-branch命令应该这样写：

git filter-branch --subdirectory-filter ./src/project -- --all

• --subdirectory-filter ./src/project：告诉Git只保留和这个目录相关的所有提交，并且把该目录的内容直接放到仓库根目录（不再嵌套src/project层级）
• -- --all：表示对仓库里的所有分支生效，如果只需要处理当前分支，可以去掉这部分

执行完后，仓库里只会剩下原./src/project里的文件，所有提交记录也会被过滤成仅和这个包相关的内容。

步骤3：验证提交历史 #

用这个命令确认历史记录是否符合预期：

git log --pretty=oneline

你应该只能看到修改过原./src/project目录下文件的提交，没有多余的杂项记录。

步骤4：推送到新的独立仓库 #

把这个干净的仓库推送到你新建的远程仓库：

1. 移除原仓库的远程关联：

   git remote remove origin
   

2. 添加新的独立仓库远程地址：

   git remote add origin <你的新独立仓库URL>
   

3. 推送所有分支到新仓库：

   git push -u origin --all
   

额外推荐：用git filter-repo替代filter-branch（更高效） #

Git官方现在更推荐用git filter-repo做历史重写，它比filter-branch更快更稳定。如果你的Git版本支持（一般Git 2.22+自带），可以用这个命令替代步骤2：

git filter-repo --path ./src/project --path-rename ./src/project/:./

• --path ./src/project：指定只保留这个路径下的文件
• --path-rename ./src/project/:./：把原目录路径重命名为根目录，让文件直接处于仓库根层级

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