Linux fd搜索隐藏文件与忽略规则怎么区分

用 fd 找文件时，最容易混淆的是“隐藏文件”和“被 ignore 规则排除的文件”。它们不是同一件事：前者由路径是否以点号开头决定，后者由 .gitignore、.fdignore 或全局 ignore 文件决定。fd 的默认行为是两类都跳过，所以文件明明存在，结果里却没有它。

官方地址：https://github.com/sharkdp/fd

只想把隐藏文件加回来，用 -H；只想取消 ignore 规则，用 -I；需要把两类都纳入搜索，用 -HI 或 -u。不要把“看不见”直接归因于同一个开关。

fd 默认为什么看不到某些文件

可以把一次搜索拆成三层：搜索根目录、文件名匹配、结果过滤。默认情况下，fd 在文件名匹配之后还会应用两套过滤：隐藏项过滤，以及 ignore 规则过滤。只要任意一套把路径排除，最终结果就不会显示它。

例如，.env 可能只是隐藏文件；build/cache.txt 可能因为命中了仓库里的 .gitignore；一个路径也可能同时满足两种条件。先判断它属于哪一类，再选择开关，排查会更快。

-H 和 -I 分别解决什么问题

-H（--hidden）只负责搜索隐藏文件和隐藏目录，不会自动取消 .gitignore 等规则。反过来，-I（--no-ignore）只负责不再遵守 ignore 文件，也不会让隐藏项自动出现。

# 只打开隐藏项，仍然遵守 .gitignore 和 .fdignore
fd -H 'env' .

# 只取消 ignore 规则，隐藏文件仍然按默认规则跳过
fd -I 'cache' .

# 同时打开隐藏项并取消 ignore 过滤
fd -HI 'config' .

这里的关键不是记住字母，而是把问题分成两个判断：目标路径是不是隐藏项？它是否被某个 ignore 模式命中？只打开其中一个开关，另一个边界仍然存在。

-H、-I、-HI 和 -u 到底怎么选

如果任务是“查看项目里的隐藏配置”，先用 fd -H；如果任务是“确认被 Git 忽略的构建产物”，用 fd -I；如果是一次性盘点目录中所有可能的文件，使用 fd -HI 或更直观的 fd -u。

# 完全放开隐藏项和 ignore 规则，用于盘点全部候选路径
fd -u 'settings' /srv/project

# 只排除 .git 目录，其他隐藏项和 ignore 路径仍按 -HI 的范围搜索
fd -HI -E .git 'config' /srv/project

-u 是 --unrestricted 的缩写，适合表达“不要应用这两类默认限制”。但它会扩大结果集合，输出可能明显变多；生产脚本中最好再配合根目录、文件类型或排除模式缩小范围。

.fdignore、-E 与 .gitignore 不是一回事

.gitignore 通常描述 Git 不追踪的路径，.fdignore 是 fd 专用的忽略文件；fd 也支持其他工具使用的 .ignore 文件。它们都属于“ignore 规则”，但来源和维护目的可能不同。

临时排除某个目录或文件时，可以用 -E（--exclude）给出 glob 模式；需要长期排除时，再把规则放入项目或全局 ignore 文件。这样可以避免为了一个临时查询修改团队共享的 .gitignore。

# 临时跳过 .git 和备份文件；注释说明每个排除项的目的
fd -HI -E .git -E '*.bak' 'report' .

# 需要长期统一排除时，在 ~/.fdignore 中写入 glob 规则
# /mnt/external-drive
# *.bak

仍然搜不到时的排查清单

第一，确认目标是文件名还是完整路径。fd 默认匹配文件名；如果模式出现在父目录路径中，需要加 -p（--full-path）。第二，把隐藏项与 ignore 规则分开测试：先用 -H，再用 -I，最后才用 -u。第三，检查模式是否被 shell 解释；正则包含方括号、脱字符或美元符号时，使用单引号包住模式。

# 注释说明：-p 让模式参与完整路径匹配，单引号避免 shell 改写正则
fd -u -p 'config/.*\.yaml$' /srv/project

可以用下面这张小表快速选择：

相关问题

为什么用了 -H 还是看不到 .gitignore 里的文件？因为 -H 只打开隐藏项，ignore 规则仍然生效；需要再加 -I。

-u 和 -HI 有什么区别？在本文关注的隐藏项与 ignore 规则上，两者都用于放开默认过滤；-u 更适合表达完整放开，-HI 更直观地写出两个独立开关。

为什么加了 -I 结果突然很多？因为它会把原本由 Git 或 fd ignore 文件排除的路径重新纳入结果，通常应同时限制搜索根目录、文件类型或使用 -E。