Agent Skills
返回列表
递归枚举目录文件

递归枚举目录文件

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/louf20268215。

技能介绍

问题场景

当你在写脚手架工具或需要扫描整个源码目录时,第一个绕不开的问题就是:如何快速拿到目录下所有文件的路径?手动写 fs.readdir 递归不仅容易踩到符号链接的坑,还常常为了一个临时需求引入庞大的 glob 库,依赖体积瞬间膨胀。

这个技能的思路很直接——如果只需要列出文件,何必把整个文件系统扫描引擎都搬进来?

工作原理

核心基于轻量库 totalist,它专注于一件事:递归遍历目录并返回所有文件的路径信息。技能的工作流分三步:

  1. 安装依赖 totalist,不需要任何额外的二进制或平台适配。
  2. 调用 listFiles 方法,传入目录路径,它会同步返回每个文件的 相对路径、绝对路径和 文件统计信息(stats),这些字段足够你做进一步的处理。
  3. 按规则过滤——比如只保留 .ts 文件,或按体积大小筛选,可以直接在回调里写判断条件,技能本身不做过滤。

实现的关键注释都标了 "小四原创",让你一眼能定位修改点。

适用边界

这个技能不是万能的。它不解析复杂的 .gitignore 规则,如果你想精确忽略 node_modules 或自定义忽略模式,需要另外接专门的忽略工具。同样,它不具备 fast-glob 那样的 DSL 模式匹配引擎,不支持 **/*.js 这类通配符查询——如果你的场景需要正则匹配或复杂的文件名模式,请直接用 fast-glob。

它最适合的场景是:轻量级脚手架扫描源码、CI 任务里快速收集文件清单、或任何需要最小依赖的递归文件枚举。写一个几行的脚本就能跑,没有学习成本,也不拖慢安装速度。

使用场景

  • 写项目脚手架时需扫描模板目录下全部文件并生成清单供后续批量写入
  • CI 流水线构建前端项目前需按扩展名过滤出所有 `.svg` 资源并统计总体积
  • 写代码分析小工具时需递归读取源码目录并按文件体积筛选出最大的几个文件
  • 临时需要遍历一个大目录收集全部文件路径但不想引入 `fast-glob` 这类完整匹配引擎

适合人员

  • 编写项目脚手架工具的开发者,需要快速枚举模板目录下所有文件并输出清单
  • 搭建 CI 流水线的工程师,在构建前扫描源码目录按后缀过滤特定类型文件
  • 写轻量命令行工具的开发者,希望用最少依赖实现递归文件枚举而不引入大型 glob 库