feature.manyFiles 是什么
feature.manyFiles 是大文件数仓库的推荐配置快捷方式：开启后，索引版本默认切到 4、未跟踪缓存默认开启，并把若干与索引相关的默认值调向「文件多、目录深」友好的方向，省去逐项调参。它不改变行为语义，只是切换一组推荐默认值；展开项随 Git 版本可能变化，跨版本团队以实测为准。
基本信息
| 启用 | git config feature.manyFiles true |
|---|---|
| 展开效果 | 索引版本 4、未跟踪缓存开启（随版本可能还有其它项） |
| 验证 | git update-index --show-index-version 实测索引版本 |
| 复核显式配置 | git config --show-origin --get-regexp 'index\.|core\.untracked' |
| 特点 | 展开值不出现在 config 显式输出里，属读取时默认值 |
| 兼容性 | 旧工具链对索引格式的支持要先确认 |
典型使用场景
- 大仓库提速：几万文件的仓库 status 与 add 更快
- 团队模板：开发机初始化脚本统一开启
- 试验评估：先在克隆副本开启并测量，再决定推广
- 兼容排查：工具报索引格式不支持时定位来源
- 回退处理：不兼容时回退索引版本或先升级工具
- 对照复核：show-origin 查看显式值来自哪个配置文件
常用示例
常用示例
git config feature.manyFiles true # 启用推荐组合
git config --show-origin --get-regexp 'index\.|core\.untracked' # 查看显式配置来源
git update-index --show-index-version # 实测索引版本（新写出的应为 4）
git update-index --index-version=2 # 需要回退格式时显式指定要点
| 要点 | 说明 | 备注 |
|---|---|---|
| 索引版本 | 默认切到 4 | 已存在的索引重新写出后生效 |
| 未跟踪缓存 | 默认开启 | 配合 status 一起提速 |
| 显式输出 | 展开值不显示 | 用行为验证而非 config --get |
| 旧工具链 | 可能不识别新格式 | 升级或回退后再启用 |
它是「一组建议配置的快捷方式」，团队要在测试仓库验证兼容性后再推广。
展开值是读取时的默认行为，不会出现在 git config 的显式列表里：验证生效用 update-index --show-index-version 这类行为指标。
不同 Git 版本展开的配置项有差异，跨版本团队以实测结果为准。