Note

Appearance

fast-glob ​

快速、高性能的文件路径匹配库，用于批量查找文件/目录。

1 安装 ​

bash
pnpm add fast-glob

2 引入方式 ​

js
// ESM
import fg from 'fast-glob';

// CommonJS
const fg = require('fast-glob');

3 基础用法 ​

异步（推荐） ​

javascript
const files = await fg('**/*.js');

同步 ​

javascript
const files = fg.sync('**/*.js');

4 匹配规则 ​

  • * 匹配当前目录所有内容
  • ** 递归匹配所有子目录
  • ! 排除路径
  • {a,b} 多后缀匹配
  • ? 匹配单个字符

5 常用示例 ​

javascript
// 匹配所有 js/ts 文件
const files = await fg(['**/*.js', '**/*.ts']);

// 排除 node_modules
const files = await fg('**/*.js', {
  ignore: ['node_modules/**'],
});

// 获取绝对路径
const files = await fg('**/*', { absolute: true });

// 只获取目录
const dirs = await fg('**/', { onlyDirectories: true });

// 只获取文件
const files = await fg('**/*', { onlyFiles: true });

// 匹配隐藏文件
const files = await fg('**/.*', { dot: true });

6 常用配置项 ​

配置项说明默认值
cwd查找根目录process.cwd()
absolute返回绝对路径false
onlyFiles只返回文件true
onlyDirectories只返回目录false
ignore排除规则[]
deep递归深度Infinity
dot匹配 . 开头文件false
unique去重true