---
title: "Git 并行检出配置官方资料摘录"
author: "Perrin Yong"
author_profile: https://www.pystone.net/profile/
published_by: "Perrin Yong"
canonical: https://www.pystone.net/notes/git-sparse-checkout-config-reference/
type: note
content_role: unspecified
visibility: public
id_stability: rename-stable
source_path: "99-资料来源、摘录与归档/01-外部文章与转载摘录/Git 并行检出配置官方资料摘录.md"
content_hash: 0297981ad2bc5af97e0aa7bf4c805722a7f227efa684fae706f28e751d5e9f5a
knowledge_version: 224c990773de.5fa8af6e39fa
site_commit: 224c990773de166d23a886306577dd90379529ce
notes_commit: 5fa8af6e39fa3891d1b9b4832bfa6c4e0ecaaf0a
---
# Git 并行检出配置官方资料摘录

> **source · 来源摘录**
> 本文摘录 Git 官方 `git-config` 文档中与工作树并行检出有关的配置语义。官方资料说明能力、默认值和适用条件；本知识库中的具体耗时与收益仍属于本地测量，不能反向当作 Git 的普遍性能承诺。

## 来源

- Git Documentation：[*git-config*](https://git-scm.com/docs/git-config)，条目 `checkout.workers` 与 `checkout.thresholdForParallelism`
- 核对版本：在线文档显示 2.55.0，2026-06-29 更新
- 核对日期：2026-07-23

## 两个配置项分别控制什么

`checkout.workers` 控制更新工作树时使用的并行 worker 数量。默认值为 1，即顺序执行；设置为小于 1 的值时，Git 使用与可用逻辑核心数相当的 worker。该配置与并行阈值会影响执行 checkout 的多种命令，包括 checkout、clone、reset 和 sparse-checkout 等，而不只影响 `git checkout` 这一条命令。

`checkout.thresholdForParallelism` 控制尝试并行检出的最小文件数量，默认值为 100。文件较少时，创建子进程和进程间通信的成本可能超过并行收益，所以阈值表达的是“何时值得启动并行”，不是另一种 worker 数量。

## 官方给出的适用边界

Git 文档指出，并行检出通常更可能在 SSD 或 NFS 上获得较好表现；在机械硬盘或核心数较少的机器上，默认的顺序检出往往更合适。仓库规模与压缩程度也会影响收益。因此不能只根据“存在并行选项”就断言它必然更快，更不能把某台机器上的加速比例外推为通用常数。

## 对当前知识库的适用结论

本库的暂存快照校验需要把 Git index 物化到临时工作树。保持 index、审批记录、validator 范围和失败语义不变，只调整物化阶段的 worker 与阈值，属于在同一语义边界内优化局部成本。它是否值得启用，应通过相同仓库、相同快照和相同校验路径的顺序/并行对照来判断。

本库实测结果及其证据边界记录在[性能优化的本质是控制成本发生的频率、时机与范围](https://www.pystone.net/notes/performance-optimization-cost-frequency-scope/)。官方文档支持配置含义和边界，本地对照支持当前环境中的效果；二者不能互相替代。