{"meta":{"title":"将子文件夹拆分为新存储库","intro":"您可以将 Git 仓库内的文件夹变为全新的仓库。","product":"开始","breadcrumbs":[{"href":"/zh/get-started","title":"开始"},{"href":"/zh/get-started/using-git","title":"使用 Git"},{"href":"/zh/get-started/using-git/splitting-a-subfolder-out-into-a-new-repository","title":"拆分子文件夹"}],"documentType":"article"},"body":"# 将子文件夹拆分为新存储库\n\n您可以将 Git 仓库内的文件夹变为全新的仓库。\n\n> \\[!NOTE]\n> 需要 Git 版本 2.22.0 或更高版本才能按照这些说明进行操作，否则 `git filter-repo` 将不起作用。\n\n如果您创建仓库的新克隆副本，则将文件夹拆分为单独的仓库时不会丢失任何 Git 历史记录或更改。 但是，请注意，新存储库不会具有原始存储库的分支和标记。\n\n1. 打开终端终端Git Bash。\n\n2. 将当前工作目录切换到您要创建新仓库的目录位置。\n\n3. 克隆包含该子文件夹的仓库。\n\n ```shell\n git clone https://github.com/USERNAME/REPOSITORY-NAME\n ```\n\n4. 将当前工作目录切换到克隆的存储库。\n\n ```shell\n cd REPOSITORY-NAME\n ```\n\n5. 若要从存储库中的其余文件中筛选出子文件夹，请安装 [`git-filter-repo`](https://github.com/newren/git-filter-repo)，然后使用以下参数运行 `git filter-repo`。\n\n * `FOLDER-NAME`：项目中要在其中创建单独存储库的文件夹。\n\n \n\n > \\[!TIP]\n > Windows用户应使用 `/` 分隔文件夹。\n\n
\n\n ```shell\n $ git filter-repo --path FOLDER-NAME/\n # Filter the specified branch in your directory and remove empty commits\n ```\n\n 现在，该仓库应仅包含您的子文件夹中的文件。\n\n 如果希望将某个特定子文件夹用作新存储库的新根文件夹，可使用以下命令：\n\n ```shell\n $ git filter-repo --subdirectory-filter FOLDER-NAME\n # Filter the specific branch by using a single sub-directory as the root for the new repository\n ```\n\n6. 在 GitHub 上[创建新存储库](/zh/repositories/creating-and-managing-repositories/creating-a-new-repository)。\n\n7. 在 GitHub 的快速设置页面上的新存储库顶部，单击 以复制远程存储库 URL。\n\n \n\n > \\[!TIP]\n > 有关 HTTPS 和 SSH URL 之间区别的信息，请参阅 [关于远程仓库](/zh/get-started/git-basics/about-remote-repositories)。\n\n8. 使用您为仓库复制的 URL 来新增远程名称。 例如，`origin` 或 `upstream` 是两个常见的选项。\n\n ```shell\n git remote add origin https://github.com/USERNAME/REPOSITORY-NAME.git\n ```\n\n9. 用新的存储库名称验证是否已添加远程 URL。\n\n ```shell\n $ git remote -v\n # Verify new remote URL\n > origin https://github.com/USERNAME/NEW-REPOSITORY-NAME.git (fetch)\n > origin https://github.com/USERNAME/NEW-REPOSITORY-NAME.git (push)\n ```\n\n10. 将更改推送到 GitHub 上的新存储库。\n\n ```shell\n git push -u origin BRANCH-NAME\n ```"}