Git中的浅克隆：何时以及如何使用

Git中的浅克隆只获取部分提交历史。当CI任务、部署步骤或快速检查任务需要当前代码但不需要多年历史时，它们非常有用。

对于每个开发者的工作站来说，它们并不是最佳默认选择。浅克隆可以节省时间和磁盘空间，但在你获取更多提交之前，它会限制基于历史的命令。

什么是浅克隆？

标准克隆会获取足够的历史记录，以便进行正常的分支工作、历史检查、旧标签检出和离线调查。浅克隆会在你选择的深度截断该历史记录。

例如，--depth 1 获取所选分支的最新提交。--depth 50 获取更近期的历史记录，但仍然不是完整的祖先链。

使用浅克隆的好处

主要好处是降低传输成本：

• 大型仓库的首次检出更快。
• 短期构建代理上占用更少的磁盘空间。
• 在慢速或计量网络上占用更少的带宽。
• 初始克隆期间Git需要处理的历史记录更少。

在构建当前提交并丢弃工作区的CI管道中，浅克隆通常是一个明显的优势。

浅克隆的缺点和限制

代价是缺失历史记录：

• git log 在浅边界处停止。
• git blame 可能无法追踪更早的更改。
• 旧标签或提交可能无法获取，直到被获取。
• 如果Git需要缺失的合并基础，变基和合并可能会更困难。
• 某些发布或审计工作流期望完整的历史记录。

如果你的工作经常涉及调试旧回归、准备发布或反向移植更改，请从完整克隆开始。

如何创建浅克隆

使用 git clone --depth：

git clone --depth <number> <repository_url>

例如，克隆一个仓库并只获取最新的10个提交：

git clone --depth 10 https://github.com/example/large-repo.git

对于只需要分支最新提交的构建任务：

git clone --depth 1 https://github.com/example/project.git

要克隆特定分支：

git clone --depth 1 -b develop https://github.com/example/project.git

当你只想要该分支的历史记录时，还可以添加 --single-branch：

git clone --depth 1 --single-branch --branch develop https://github.com/example/project.git

管理浅克隆

获取更多历史记录（加深克隆）

如果在克隆后需要更多历史记录，加深仓库：

git fetch --deepen=50 origin

这会获取当前浅边界之外的50个提交。

你也可以设置你想要的总体深度：

git fetch --depth=100 origin

重要的一点：git remote set-depth 不是一个有效的Git命令。深度是通过克隆和获取选项控制的。

获取标签

浅克隆可能不包括所有标签，尤其是指向较旧提交的标签。仅当你的工作流需要时才获取标签：

git fetch --tags origin

取消浅克隆

要将浅克隆转换为完整克隆，获取剩余的历史记录：

git fetch --unshallow origin

此命令将从远程仓库下载剩余的历史记录。

从浅克隆推送

当你的新提交基于你获取的远程分支最新提交时，从浅克隆推送可以工作。但对于长期开发来说，它仍然不是一个好的选择，因为缺失的历史记录会使变基、冲突解决和审查更加困难。

如果遇到与历史记录相关的推送或合并问题，请在继续之前获取更多历史记录或取消浅克隆。

何时使用浅克隆

当任务短暂且历史记录不重要时使用它们：

• CI/CD检出。
• 只读检查。
• 临时重现环境。
• 文档构建。
• 慢速网络上的大型仓库。

何时不使用浅克隆

当你经常需要以下内容时避免使用它们：

• 深入的 git log、git blame 或 git bisect。
• 使用旧标签的发布工作。
• 复杂的合并或变基工作。
• 跨历史的离线调试。
• 期望完整克隆的贡献工作流。

实用要点

对于只需要最新代码的一次性任务，使用 git clone --depth 1。对于正常开发，使用完整克隆，除非你有明确的理由不这样做。

如果浅克隆开始妨碍你，使用 git fetch --deepen=<number> origin 加深它，或使用 git fetch --unshallow origin 转换它。这通常比一次一个命令地处理缺失历史记录错误更快、更安全。