Symfony 7.3 中 Finder 默认不自动跳过 .git 目录，推荐用 $finder->exclude('.git') 显式排除；ignoreVcs(true) 已默认开启，ignoreVcsIgnored(true) 可进一步加载 .gitignore 规则。
在 Symfony 7.3 中，Finder 默认不会自动跳过 .git 目录，但你可以显式配置它忽略版本控制元数据目录，避免扫描冗余内容、提升性能并防止意外读取敏感信息（如 .git/config 或 commit 对象）。
直接排除 .git 目录的推荐写法
使用 exclude() 方法是最清晰、最可靠的方式：
-
$finder->exclude('.git');—— 排除根级.git目录（适用于in(__DIR__)等单路径场景） -
$finder->exclude(['.git', '.svn', '.hg']);—— 同时排除多种 VCS 元数据目录 - 该方法作用于所有层级：只要某子目录名为
.git，无论嵌套多深都会被跳过
配合 gitignore 规则自动过滤（可选进阶）
如果你希望 Finder 行为更贴近 Git 的实际忽略逻辑（比如也跳过 .gitignore 中声明的文件），可启用内置的 Gitignore 加载器：
-
$finder->ignoreVcs(true);—— 自动跳过.git、.svn等标准 VCS 目录（Symfony 7.3 已默认开启此行为，但显式调用更明确） -
$finder->ignoreVcsIgnored(true);—— 进一步读取项目中每个.gitignore文件，并跳过其中匹配的路径（需确保.gitignore在搜索路径内） - 注意：
ignoreVcsIgnored(true)会带来轻微开销，仅在需要严格对齐 Git 忽略语义时启用
验证是否生效的小技巧
快速确认 .git 是否被跳过：
- 用
count($finder)对比开启/关闭exclude('.git')前后的结果数量变化 - 临时加一行
->depth('< 2')并打印路径，观察输出中是否还出现.git/子串 - 若仍看到
.git内容，检查是否误用了notPath()或正则匹配，这些不等价于exclude()
常见误区提醒
以下写法不能替代 exclude('.git')：
-
->notName('.git')：只跳过文件名是.git的“文件”，而.git是目录，无效 -
->path('/\.git/')：正则匹配路径，语法复杂且易出错，且不阻止进入该目录内部 - 依赖
ignoreVcs(true)却未确认 Symfony 版本 —— 该方法在 7.3 中存在且稳定，但在旧版（如 5.x）中行为略有差异
