如何克隆仅Git存储库的子目录？

作者: 子阳
发布时间: 2024-12-28 05:32:56 (18天前)
转自：

9 条回复

0#
回复此人
Charizard | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 的<strong> 编辑 </强> ：从Git 2.19开始，这最终成为可能，正如在这个答案中可以看到的那样： <a href="https://stackoverflow.com/a/52269934/2988"> https://stackoverflow.com/a/52269934/2988 </A> 。 </p> <P> 考虑提出这个答案。 </p> <P> 注意：在Git 2.19中，仅实现了客户端支持，仍然缺少服务器端支持，因此它仅在克隆本地存储库时有效。另请注意大型Git托管服务商，例如GitHub，实际上并没有使用Git服务器，他们使用自己的实现，所以即使支持显示在Git服务器上，它也不会自动意味着它可以在Git托管服务器上运行。（OTOH，因为他们不使用Git服务器，他们可以在它们自己的实现中更快地实现它，然后才能在Git服务器中显示它。） </p> <HR /> <P> 不，这在Git中是不可能的。 </p> <P> 在Git中实现类似的功能将是一项重大工作，这意味着无法再保证客户端存储库的完整性。如果您有兴趣，请在git mailinglist上搜索关于“sparse clone”和“sparse fetch”的讨论。 </p> <P> 一般来说，Git社区的共识是，如果你有几个总是独立检出的目录，那么这些实际上是两个不同的项目，应该存在于两个不同的存储库中。您可以使用将它们粘合在一起 <a href="https://book.git-scm.com/book/en/v2/Git-Tools-Submodules" rel="noreferrer"> Git子模块 </A> 。 </p> </DIV>

编辑
1#
回复此人
易米烊光 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 对于其他用户的<strong> <EM> 只是想下载 </EM> </强> 来自github的文件/文件夹，只需使用： </p> <pre> <code> svn export <repo>/trunk/<folder> </code> </pre> <P> 例如 </p> <pre> <code> svn export https://github.com/lodash/lodash.com/trunk/docs </code> </pre> <P> （是的，这是svn在这里。显然在2016年你仍然需要svn来简单地下载一些github文件） </p> <P> 礼貌： <a href="https://stackoverflow.com/questions/7106012/download-a-single-folder-or-directory-from-a-github-repo"> 从GitHub仓库下载单个文件夹或目录 </A> </p> <P> 的<strong> 重要 </强> - 确保更新github URL并替换 <code> /tree/master/ </code> 用'/ trunk /'。 </p> <P> 作为bash脚本： </p> <pre> <code> git-download(){ folder=${@/tree\/master/trunk} folder=${folder/blob\/master/trunk} svn export $folder } </code> </pre> <P> 的<strong> 注意 </强> 此方法下载文件夹，不克隆/签出。您无法将更改推送回存储库。另一方面 - 与稀疏结账或浅结账相比，这导致更小的下载。 </p> </DIV>

编辑
2#
回复此人
是吗@ | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> Git 1.7.0有“稀疏结账”。看到 “core.sparseCheckout”中的 <a href="http://git-scm.com/docs/git-config" rel="noreferrer"> <EM> git config </EM> 手册页 </A> ， “稀疏结账”中 <a href="http://www.kernel.org/pub/software/scm/git/docs/git-read-tree.html#_sparse_checkout" rel="noreferrer"> <EM> git read-tree </EM> 手册页 </A> ，和 “Skip-worktree bit”中的 <a href="http://www.kernel.org/pub/software/scm/git/docs/git-update-index.html#_skip_worktree_bit" rel="noreferrer"> <EM> git update-index </EM> 手册页 </A> 。 </p> <P> 接口不如SVN那样方便（例如，在初始克隆时无法进行稀疏检出），但现在可以使用可以构建更简单接口的基本功能。 </p> </DIV>

编辑
3#
回复此人
v-star*위위 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 如果您从未计划与克隆的存储库进行交互，则可以执行完整操作的<strong> git clone </强> 并使用重写您的存储库的<strong> git filter-branch --subdirectory-filter </强> 。这样，至少会保留历史记录。 </p> </DIV>

编辑
4#
回复此人
记忆只剩空城 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 这是我为单个子目录稀疏结账的用例编写的shell脚本 </p> <H2> coSubDir.sh </H2> <pre> <code> localRepo=$1 remoteRepo=$2 subDir=$3 # Create local repository for subdirectory checkout, make it hidden to avoid having to drill down to the subfolder mkdir ./.$localRepo cd ./.$localRepo git init git remote add -f origin $remoteRepo git config core.sparseCheckout true # Add the subdirectory of interest to the sparse checkout. echo $subDir >> .git/info/sparse-checkout git pull origin master # Create convenience symlink to the subdirectory of interest cd .. ln -s ./.$localRepo$subDir $localRepo </code> </pre> </DIV>

编辑
5#
回复此人
一腔诗意喂了狗 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 你要做的是做一个的<strong> 稀疏结账 </强> ，该功能已添加到git 1。7。0（2012年2月）。做稀疏的步骤 <EM> 克隆 </EM> 如下面所述： </p> <pre> <code> mkdir <repo> cd <repo> git init git remote add -f origin <url> </code> </pre> <P> 这将使用您的遥控器创建一个空的存储库，并获取所有对象但不检查它们。然后做： </p> <pre> <code> git config core.sparseCheckout true </code> </pre> <P> 现在，您需要定义要实际检出的文件/文件夹。这是通过列出它们来完成的 <code> .git/info/sparse-checkout </code> ，例如： </p> <pre class="lang-bash prettyprint-override"> <code> echo "some/dir/" >> .git/info/sparse-checkout echo "another/sub/tree" >> .git/info/sparse-checkout </code> </pre> <P> 最后但并非最不重要的是，使用远程状态更新您的空仓库： </p> <pre> <code> git pull origin master </code> </pre> <P> 您现在将“检出”文件 <code> some/dir </code> 和 <code> another/sub/tree </code> 在您的文件系统上（仍然存在这些路径），并且不存在其他路径。 </p> <P> 你可能想看一下 <a href="http://jasonkarns.com/blog/subdirectory-checkouts-with-git-sparse-checkout/" rel="noreferrer"> 扩展教程 </A> 你可能应该阅读这位官员 <a href="http://schacon.github.com/git/git-read-tree.html#_sparse_checkout" rel="noreferrer"> 稀疏结账的文档 </A> 。 </p> <P> 作为一个功能： </p> <pre class="lang-bash prettyprint-override"> <code> function git_sparse_clone() ( rurl="$1" localdir="$2" && shift 2 mkdir -p "$localdir" cd "$localdir" git init git remote add -f origin "$rurl" git config core.sparseCheckout true # Loops over remaining args for i; do echo "$i" >> .git/info/sparse-checkout done git pull origin master ) </code> </pre> <P> 用法： </p> <pre class="lang-bash prettyprint-override"> <code> git_sparse_clone "http://github.com/tj/n" "./local/location" "/bin" </code> </pre> <HR /> <P> 请注意，这仍将从服务器下载整个存储库 - 只有结帐大小减少。目前，无法仅克隆单个目录。但是，如果您不需要存储库的历史记录，则可以通过创建浅层克隆来至少节省带宽。看到 <a href="https://stackoverflow.com/a/28039894/962603"> 乌丹丹的回答 </A> 下面有关如何组合浅的信息 <a href="https://git-scm.com/docs/git-clone" rel="noreferrer"> 克隆 </A> 和稀疏结帐。 </p> </DIV>

编辑
6#
回复此人
！啊啊 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 仅使用Git克隆子目录是不可能的，但下面是几个解决方法。 </p> <H3> 过滤分支 </H3> <P> 您可能希望重写存储库以使其看起来像 <code> trunk/public_html/ </code> 曾经是它的项目根，并丢弃所有其他历史（使用 <a href="https://git-scm.com/docs/git-filter-branch"> <code> filter-branch </code> </A> ），尝试已结帐分支： </p> <pre> <code> git filter-branch --subdirectory-filter trunk/public_html -- --all </code> </pre> <P> <SUP> 备注： <code> -- </code> 将过滤器分支选项与修订选项分开，以及 <code> --all </code> 重写所有分支和标签。所有信息包括原始提交时间或合并信息的<strong> 罐头 </强> 。这个命令很荣幸 <code> .git/info/grafts </code> 文件和引用 <code> refs/replace/ </code> 命名空间，所以如果您有任何移植或替换 <code> refs </code> 定义，运行此命令将使它们永久化。 </SUP> </p> <BLOCKQUOTE> <P> 警告！重写的历史将具有所有对象的不同对象名称，并且不会与原始分支会聚。您将无法在原始分支的顶部轻松推送和分发重写的分支。如果您不知道完整的含义，请不要使用此命令，并且无论如何都要避免使用它，如果简单的单个提交就足以解决您的问题。 </p> </BLOCKQUOTE> <HR /> <H3> 稀疏结账 </H3> <P> 这里有简单的步骤 <a href="https://git-scm.com/docs/git-read-tree"> 稀疏结账 </A> 将稀疏地填充工作目录的方法，这样你就可以告诉Git工作目录中哪些文件夹或文件值得检出。 </p> <OL> <LI> <P> 像往常一样克隆存储库（ <code> --no-checkout </code> 是可选的）： </p> <pre> <code> git clone --no-checkout git@foo/bar.git cd bar </code> </pre> <P> <SUP> 如果已经克隆了存储库，则可以跳过此步骤。 </SUP> </p> <P> 提示：对于大型回购，请考虑 <a href="https://git-scm.com/docs/git-read-tree"> 浅克隆 </A> （ <code> --depth 1 </code> ）只签出最新版本或/和 <code> --single-branch </code> 只要。 </p> </LI> <LI> <P> 启用 <code> sparseCheckout </code> 选项： </p> <pre> <code> git config core.sparseCheckout true </code> </pre> </LI> <LI> <P> 指定稀疏结帐的文件夹（的<strong> 无 </强> 最后的空间）： </p> <pre> <code> echo "trunk/public_html/*"> .git/info/sparse-checkout </code> </pre> <P> 或编辑 <code> .git/info/sparse-checkout </code> 。 </p> </LI> <LI> <P> 检查分支（例如 <code> master </code> ）： </p> <pre> <code> git checkout master </code> </pre> </LI> </醇> <P> 现在您应该在当前目录中选择了文件夹。 </p> <P> 如果您有太多级别的目录或过滤分支，您可以考虑使用符号链接。 </p> <HR /> </DIV>

编辑
7#
回复此人
别闹 | 2019-08-31 10-32

<div class =“post-text”itemprop =“text”> <P> 我只是 <a href="https://github.com/mfbx9da4/git-sub-dir" rel="nofollow noreferrer"> 写了一个脚本 </A> 对于 <a href="http://en.wikipedia.org/wiki/GitHub" rel="nofollow noreferrer"> GitHub上 </A> 。 </p> <P> 用法： </p> <pre> <code> python get_git_sub_dir.py path/to/sub/dir <RECURSIVE> </code> </pre> </DIV>

编辑

登录后才能参与评论