f_GetList函数
函数名：wj_获取文件列表 / f_GetList
函数功能
获取指定文件夹下所有文件列表，支持递归子目录搜索及文件类型筛选。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 | ||
|---|---|---|---|---|---|---|
folderPath | String | 是 | "C:\\Documents" | 目标文件夹的完整路径 | ||
includeSubfolders | Boolean | 否 | TRUE | 是否包含子目录，默认TRUE | ||
searchPattern | String | 否 | `"*.txt | *.xlsx"` | 文件类型过滤，支持多类型用` | 分隔，默认.` |
使用案例
3.1 获取指定目录所有文件
问题描述：列出指定文件夹内所有文件（含子目录） 公式演示：
excel
=f_GetList("D:\\Reports")输出效果： 返回所有文件路径的纵向列表。
3.2 筛选指定类型文件
问题描述：只获取文件夹中.txt和.xlsx文件 公式演示：
excel
=f_GetList("D:\\Reports", TRUE, "*.txt|*.xlsx")输出效果： 返回符合类型的文件路径列表。
3.3 仅当前目录文件
问题描述：不包含子文件夹文件 公式演示：
excel
=f_GetList("D:\\Reports", FALSE)输出效果： 只列出当前目录文件路径。
技术说明
4.1 搜索逻辑
- 使用
Directory.GetFiles，根据includeSubfolders参数决定搜索深度 - 通过分割
searchPattern支持多类型联合筛选
4.2 返回格式
- 返回二维数组，适合直接填充Excel单元格
- 单列显示完整文件路径
4.3 异常处理
| 错误场景 | 返回值 |
|---|---|
| 目录不存在 | 错误：目录不存在 |
| 其他异常 | 错误: 异常信息 |
扩展应用
6.1 批量文件管理
结合文件重命名、删除等操作实现批量处理
6.2 条件筛选辅助
可配合Excel筛选功能快速定位指定类型文件
注：本函数在WPS 2019+和Excel 365中测试通过