在TortoiseGit中执行pull操作时如何指定拉取深度？

单次拉取限制设置 #

仅拉取最新1次提交 #

TortoiseGit图形化操作步骤：

• 右键点击仓库根目录，依次选择「TortoiseGit」→「Pull...」
• 在弹出的拉取配置窗口中，找到Depth下拉选项，选择值为1
• 点击「OK」执行拉取即可，本次操作只会拉取当前分支最新的1次提交，不会补全克隆之前的历史记录

命令行对应操作为：

git pull --depth 1

拉取克隆日期之后的所有新提交 #

如果需要拉取从克隆日到当前的所有新增提交，不要更早的历史，可以用--shallow-since参数：

• 打开TortoiseGit的Pull窗口后，点击「Advanced」展开高级设置
• 在「Additional parameters」输入框中填入--shallow-since="你的克隆日期"，示例：--shallow-since="2024-01-01"
• 点击「OK」执行拉取即可

命令行对应操作为：

git pull --shallow-since="2024-01-01"

（将示例日期替换为你实际执行浅克隆的日期即可）

永久生效配置 #

如果不想每次拉取都手动设置参数，可以直接修改仓库本地配置，永久生效：

• 右键点击仓库根目录，依次选择「TortoiseGit」→「Settings」
• 左侧菜单选择「Git」项，Config source选择「Local config（仅对当前仓库生效）」
• 点击「Edit local .git/config」按钮打开本地配置文件
• 找到[remote "origin"]配置段，在下方添加对应规则：
  • 要永久保持只拉取最新1次提交，添加：

    deepen = 1
    

  • 要永久拉取指定日期之后的所有提交，添加：

    shallow-since = 2024-01-01
    

    （将示例日期替换为你的实际克隆日期即可）
• 保存关闭配置文件，后续所有拉取操作都会自动遵循该规则，不会拉取克隆之前的历史记录。

补充说明 #

如果后续需要获取完整的历史提交记录，执行git fetch --unshallow即可临时解除浅克隆限制，或者删除配置文件中新增的规则即可恢复默认拉取逻辑。

内容的提问来源于stack exchange，提问作者T.Todua