从现有Git仓库中拆分出一个文件夹并生成新仓库

如果你想从现有Git仓库中拆分出一个文件夹并生成新仓库，可以按照以下步骤操作：

方法一：使用 git filter-repo（推荐）

这是最推荐的方法，它能高效地重写仓库历史，只保留指定目录的内容。

# 1. 克隆原仓库（不要在原仓库上直接操作）
git clone <原仓库URL> 原仓库名-拆分
cd 原仓库名-拆分# 2. 安装并使用 git filter-repo（如果未安装，需先安装）
# macOS: brew install git-filter-repo
# Ubuntu: apt-get install git-filter-repo
# 或使用Python版: pip install git-filter-repo# 3. 过滤出指定目录（例如：folder/to/split）
git filter-repo --path folder/to/split --path-rename folder/to/split:# 4. 检查过滤后的历史是否正确
git log  # 应该只看到与该目录相关的提交# 5. 创建新的远程仓库（在代码托管平台上手动创建，如GitHub/GitLab）# 6. 将过滤后的仓库推送到新远程仓库
git remote add new-origin <新仓库URL>
git push -u new-origin main  # 推送当前分支到新仓库的main分支

方法二：使用 git subtree（适合保留完整历史）

这种方法会保留原仓库的完整历史，但新仓库会更大。

# 1. 克隆原仓库
git clone <原仓库URL> 原仓库名-拆分
cd 原仓库名-拆分# 2. 创建一个只包含指定目录的分支
git subtree split -P folder/to/split -b split-branch# 3. 创建新的远程仓库（在代码托管平台上手动创建）# 4. 克隆一个空仓库到本地的另一个目录
git clone <新仓库URL> 新仓库名
cd 新仓库名# 5. 添加原仓库为远程仓库
git remote add original ../原仓库名-拆分  # 使用相对路径或原仓库URL# 6. 拉取拆分出的分支
git pull original split-branch# 7. 推送到新仓库的主分支
git push -u origin main

方法三：仅保留最新提交（丢弃历史）

如果你不需要保留历史，可以简单地复制目录内容到新仓库。

# 1. 创建新仓库目录并初始化
mkdir 新仓库名
cd 新仓库名
git init# 2. 从原仓库复制目录内容（不包含.git）
cp -r /path/to/original/repo/folder/to/split/* .# 3. 添加、提交并推送到新远程仓库
git add .
git commit -m "Initial commit from original repo"
git remote add origin <新仓库URL>
git push -u origin main

注意事项

1. 备份原仓库：操作前建议对原仓库进行备份，避免意外丢失数据。
2. 更新引用：拆分后，原仓库中指向被拆分目录的相对路径可能需要更新。
3. 大文件处理：如果仓库中包含大文件，建议使用 git filter-repo 的 --strip-blobs-bigger-than 参数清理。
4. 分支与标签：上述方法默认只处理主分支，如需保留其他分支或标签，需额外操作。

根据你的需求选择合适的方法，完成后原仓库和新仓库将完全独立。