Sparse Checkout
一句话解释
稀疏检出仅按路径模式用仓库文件子集填充工作树。
用大白话说
稀疏检出让你仅用仓库文件的子集填充工作目录。Git 不检出每个文件,而只物化匹配你稀疏检出模式的路径。这对只需一个包文件的 monorepo 极为有用。用 git sparse-checkout init 启用,再用 git sparse-checkout set <paths> 设模式。Cone 模式(默认)对基于目录的模式高效。仓库对象存储仍含所有文件——只是工作树是部分的。你可随时改模式,Git 相应重新物化。稀疏检出与部分克隆(--filter=blob:none)搭配,连省略文件的内容都不下载。二者合力让你处理庞大 monorepo 时只拉取并物化你触及的部分,显著降低磁盘占用与克隆时间。
示例
bash
# Clone a monorepo but only populate one package
git clone --no-checkout https://github.com/org/monorepo.git
cd monorepo
git sparse-checkout init --cone
git sparse-checkout set packages/web
# Now the working tree has only packages/web/*
# The rest of the repo is in the object store but not materialized
# Add another package later
git sparse-checkout add packages/shared--no-checkout 跳过初始检出。sparse-checkout set 定义要物化的目录。仅那些路径出现在工作树。
相关术语
相关资源
相关课程
- Git 进阶
学习稀疏检出。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。