Git sparse-checkout默认不生效是因为2.27前不支持，新版本需手动启用core.sparseCheckout和core.sparseCheckoutCone配置，且已有仓库须清空工作区并重置索引。
git sparse-checkout 为什么默认不生效
因为 sparse-checkout 功能从 Git 2.27 开始才默认启用，旧版本（比如 CentOS 7 自带的 Git 1.8）压根不支持；即使新版本，也必须显式开启核心配置，否则 git clone 或 git checkout 仍会拉全量文件。
- 执行
git config --global core.sparseCheckout true是必要前提（注意是core.sparseCheckout，不是sparse-checkout） - Git 2.32+ 还需额外设置
git config --global core.sparseCheckoutCone true才能用简化语法（如/*、!/node_modules），否则只能写完整路径模式 - 如果已克隆过仓库，得先清空工作区：删掉所有非
.git文件，再重置索引：git read-tree -m -u HEAD
怎么安全地初始化一个稀疏检出仓库
别直接在已有工作区改配置——容易残留文件、触发意外覆盖。推荐从零开始，且优先用 cone mode（更稳定、性能好、语法简单）。
- 先禁用自动检出：
git clone --no-checkout <url></url> - 进目录后启用 cone 模式：
git config core.sparseCheckoutCone true - 编辑
.git/info/sparse-checkout，写入你要的路径规则，例如：/* !/.gitignore !/README.md /src/ /tests/
- 最后执行
git checkout——此时只检出/src/和/tests/下的文件，其他全被过滤
git sparse-checkout set 命令总报错“invalid pattern”
这是没开 sparseCheckoutCone 却用了 cone 语法（比如 /*），或路径开头少了斜杠。Git 对 pattern 格式极其敏感，尤其在非 cone 模式下，必须写绝对路径匹配（以 / 开头），且不能有通配符前缀。
- 错误写法：
git sparse-checkout set src/→ 缺少开头/，会被当成相对路径忽略 - 正确写法：
git sparse-checkout set /src/ /docs/（需先git config core.sparseCheckoutCone true） - 如果关了 cone 模式，pattern 必须像这样：
/src/** !/src/**/test_*.py
，且每行都要以/开始 - Windows 用户注意：路径分隔符统一用
/，别用\，否则sparse-checkout直接静默失败
稀疏检出后 git status 显示大量 deleted 文件
这不是 bug，是预期行为：Git 记录了所有 tracked 文件，但 sparse 模式让部分文件“不可见”，于是 git status 把它们标为 deleted（实际只是未检出）。只要没手动删过，这些文件不会真丢。
- 避免误操作：别运行
git clean -fd或git reset --hard，否则真删掉未检出文件 - 想看真实变更？加
--ignored参数：git status --ignored，未检出文件会归类到 “Ignored files” 下 - 切换分支时，如果目标分支有新目录不在当前 sparse 规则里，Git 默认不自动检出——得手动
git sparse-checkout set新路径再git checkout
稀疏检出真正难的不是配置，而是规则和协作边界的对齐：CI 脚本、队友本地环境、IDE 缓存都可能绕过 sparse 设置，悄悄加载全量文件。上线前务必在干净环境验证 ls 输出是否符合预期。
