将子文件夹拆分成新仓库

Note

需要 Git 版本 2.22.0 或更高版本才能按照这些说明进行操作，否则 git filter-repo 将不起作用。

如果您创建仓库的新克隆副本，则将文件夹拆分为单独的仓库时不会丢失任何 Git 历史记录或更改。但是，请注意，新存储库不会具有原始存储库的分支和标记。

打开终端终端Git Bash。
将当前工作目录更改为您要创建新仓库的位置。

克隆包含该子文件夹的仓库。

git clone https://github.com/USERNAME/REPOSITORY-NAME

将当前工作目录更改为您克隆的仓库。
```
cd REPOSITORY-NAME
```
若要从存储库中的其余文件中筛选出子文件夹，请安装 git-filter-repo，然后使用以下参数运行 git filter-repo。
- FOLDER-NAME：项目中要在其中创建单独存储库的文件夹。
Tip

Windows 用户应使用 / 来分隔文件夹。
```
$ git filter-repo --path FOLDER-NAME/
# Filter the specified branch in your directory and remove empty commits
```
现在，该仓库应仅包含您的子文件夹中的文件。

如果希望将某个特定子文件夹用作新存储库的新根文件夹，可使用以下命令：
```
$ git filter-repo --subdirectory-filter FOLDER-NAME
# Filter the specific branch by using a single sub-directory as the root for the new repository
```
在 GitHub 上新建存储库。
在 GitHub 的快速设置页面上的新存储库顶部，单击以复制远程存储库 URL。

Tip

有关 HTTPS 和 SSH URL 之间区别的信息，请参阅“关于远程仓库”。
使用为存储库复制的 URL 添加新的远程名称。例如，origin 或 upstream 是两个常见的选项。
```
git remote add origin https://github.com/USERNAME/REPOSITORY-NAME.git
```

用新的存储库名称验证是否已添加远程 URL。

$ git remote -v
# Verify new remote URL
> origin  https://github.com/USERNAME/NEW-REPOSITORY-NAME.git (fetch)
> origin  https://github.com/USERNAME/NEW-REPOSITORY-NAME.git (push)

将您的更改推送到 GitHub 上的新仓库。
```
git push -u origin BRANCH-NAME
```

将子文件夹拆分成新仓库

Platform navigation