SuperAPI AI 工具集

fd File Finding

通用与其它

查看项目

更新于 11-11 03:10

技能介绍

fd File Finding 是 cleanscope 技能集合中的一份知识文档,主题是使用 fd 命令行工具进行快速文件查找。fd 被定位为 find 的快速、用户友好替代品,具备智能默认值和强大的过滤能力。

用途 该技能面向需要在开发工作流中按名称、扩展名、类型、大小或修改时间查找文件的场景,强调借助 fd 的智能默认值减少手工参数,并获得比传统 find 更简洁的语法。

主要能力 据资料,fd 用 Rust 编写,支持并行执行,默认输出带颜色,自动遵循 .gitignore,默认大小写不敏感(可用 -s 切换为大小写敏感),语法比 find 简单,并支持正则表达式。文档列出的筛选能力包括:按扩展名(-e,可多次指定)、按类型(-t f 文件、-t d 目录、-t l 符号链接、-t x 可执行文件,可组合)、搜索深度(-d 或 --max-depth,以及 --min-depth)、隐藏文件(-H)、被忽略文件(-I)与不受限模式(-u)、文件大小(--size,支持 + 大于、- 小于及区间)、修改时间(--changed-within 与 --changed-before,单位含 s/m/h/d/w/y)。路径方面可在指定目录中搜索、用 -E 排除路径,或用 -p 匹配完整路径。

使用方式 基础用法为 fd 加模式,例如 fd config、fd -e rs、fd -s Config;模式可为正则(如 '^test_..py$')或 glob(如 '.lua')。执行命令方面,-x 对每个结果执行命令(如 fd -e jpg -x convert {} {.}.png),-X 批量执行(如 fd -e md -X wc -l)。也可通过管道与其他工具集成,如 fd -e log | xargs rm、fd -e py | xargs rg "import numpy"、fd -e md | xargs nvim。文档还给出常见组合,例如查找最近修改的源码文件 fd -e rs --changed-within 1d、查找当前目录下大文件 fd -d 1 -t f --size +10m、查找可执行脚本 fd -t x -e sh、排除构建产物 fd -e js -E dist -E node_modules -E build。

适用场景 资料列举的场景包括:按名称或模式查找文件、在遵循 gitignore 的仓库中搜索、快速遍历目录、按类型搜索、基于时间的文件查询,以及开发工作流中定位测试文件、配置文件和源码文件,和清理操作中删除 .pyc、node_modules、旧日志、查找大文件等。

限制与注意事项 文档建议在需要复杂布尔逻辑、POSIX 兼容性、高级权限检查或非标准文件属性时改用 find。性能方面提示:若结果顺序重要可用 -j 1 顺序搜索;结合 --max-depth 限制范围;用 -t f 跳过目录处理;在仓库中利用 gitignore 加速搜索。时间单位包括 s、m、h、d、w、y,大小单位包括 b、k、m、g、t。文档未提供安装方式、版本要求或平台支持等细节信息。