dnGrep文件名模式搜索完全指南：从通配符到正则表达式的高效实践-优快云博客

dnGrep文件名模式搜索完全指南：从通配符到正则表达式的高效实践

【免费下载链接】dnGrep Graphical GREP tool for Windows 项目地址: https://gitcode.com/gh_mirrors/dn/dnGrep

引言：告别低效文件检索的痛点

你是否曾在数百个项目文件中艰难寻找特定命名模式的文件？传统搜索工具要么混杂内容匹配结果，要么仅支持基础通配符，无法满足复杂场景需求。dnGrep作为Windows平台强大的图形化GREP工具（Graphical GREP tool for Windows），提供了精准的文件名模式搜索能力，让你无需编写复杂脚本即可实现毫秒级文件筛选。本文将系统讲解如何利用dnGrep的文件名模式搜索功能，从基础通配符到高级正则表达式，结合真实代码实现与场景化示例，帮你彻底掌握这一高效检索技能。

读完本文你将获得：

3种文件名匹配模式的配置方法（通配符/正则/排除规则）
5个实战场景的完整实现步骤（含代码级参数说明）
2套性能优化方案（Everything索引集成与并行搜索）
1份可直接复用的配置模板（覆盖80%使用场景）

核心原理：dnGrep文件名过滤机制的底层实现

dnGrep的文件名模式搜索功能核心围绕FileFilter类实现，该类位于dnGREP.Common命名空间，负责封装所有文件筛选参数。其构造函数包含23个配置项，其中与文件名匹配直接相关的关键参数如下：

public FileFilter(
    string path, 
    string namePatternToInclude,  // 包含的文件名模式
    string namePatternToExclude,  // 排除的文件名模式
    bool isRegex,                 // 是否启用正则表达式
    bool useGitignore,            // 是否应用.gitignore规则
    bool useEverything,           // 是否使用Everything索引加速
    // ... 其他参数省略
)

文件名匹配的工作流程

mermaid

当isRegex=false时，系统使用*和?作为通配符（如*.cs匹配所有C#文件）；当isRegex=true时，支持完整的.NET正则表达式语法（如^Test.*\.txt$匹配以Test开头的文本文件）。这两种模式通过GrepCore类的ListFiles方法触发纯文件名搜索，跳过文件内容检查：

// GrepCore.cs中触发仅文件名搜索的关键方法
public List<GrepSearchResult> ListFiles(
    IEnumerable<FileData> files, 
    GrepSearchOption searchOptions,
    int codePage, 
    PauseCancelToken pauseCancelToken = default
)

实战指南：3种匹配模式的配置与示例

1. 基础通配符模式（适合普通用户）

适用场景：快速筛选特定类型文件或固定命名格式文件

参数配置	示例值	说明
NamePatternToInclude	`*.cs`	匹配所有C#源代码文件
NamePatternToExclude	`*Tests.cs`	排除测试文件
IsRegex	`false`	启用通配符模式
IncludeSubfolders	`true`	递归搜索子目录

代码级实现：

var filter = new FileFilter(
    path: @"C:\project",
    namePatternToInclude: "*.cs",
    namePatternToExclude: "*Tests.cs",
    isRegex: false,
    useGitignore: true,
    useEverything: false,
    includeSubfolders: true,
    maxSbufolderDepth: -1  // -1表示无限制深度
);

var core = new GrepCore { FileFilter = filter };
var results = core.ListFiles(
    files: DirectoryEnumeration.EnumerateFiles(filter),
    searchOptions: GrepSearchOption.None,
    codePage: -1
);

UI操作对应：在dnGrep主界面中，取消勾选"搜索文件内容"选项，在"文件名"输入框填入*.cs，"排除"框填入*Tests.cs，即可实现上述筛选。

2. 正则表达式模式（适合高级用户）

适用场景：复杂命名规则匹配，如版本号文件（v1.0.0.txt）、日期命名文件（2023-10-05.log）等

常用正则模式示例：

需求	正则表达式	匹配示例
匹配版本号文件	`^v\d+\.\d+\.\d+\.txt$`	v1.2.3.txt
匹配日期日志	`^\d{4}-\d{2}-\d{2}\.log$`	2023-10-05.log
匹配特定前缀类	`^Customer.*\.cs$`	CustomerModel.cs、CustomerService.cs

性能优化：当处理超过10万文件的目录时，建议启用useEverything=true，此时dnGrep会调用Everything搜索引擎的API（通过dnGREP.Everything项目实现），将搜索速度提升10-100倍。

3. 混合匹配模式（通配符+排除规则）

适用场景：需要排除特定子目录或文件类型的复杂筛选

例如：搜索所有.md文件，但排除node_modules目录和README.md文件

var filter = new FileFilter(
    path: @"C:\docs",
    namePatternToInclude: "*.md",
    namePatternToExclude: @"node_modules\*|README.md",  // 使用|分隔多个排除模式
    isRegex: false,
    useGitignore: true,  // 同时应用.gitignore规则
    useEverything: true,
    includeSubfolders: true
);

排除规则优先级：namePatternToExclude > .gitignore > namePatternToInclude，即明确排除的文件即使符合包含模式也会被过滤。

高级技巧：提升搜索效率的5个专业配置

1. 结合文件元数据筛选

通过FileFilter的日期和大小参数，可以实现更精准的筛选：

new FileFilter(
    // ... 基础参数省略
    sizeFrom: 1024,  // 最小1KB
    sizeTo: 102400,  // 最大100KB
    dateFilter: FileDateFilter.Modified,  // 基于修改日期
    startTime: DateTime.Now.AddDays(-30),  // 近30天内
    endTime: DateTime.Now
)

2. Everything索引无缝集成

启用useEverything=true时，dnGrep会调用EverythingSearch类（位于dnGREP.Everything项目）与Everything搜索引擎通信，支持其特有的高级搜索语法：

// Everything特有的文件大小搜索语法
namePatternToInclude: "size:>1mb *.pdf"
// 最近修改的Office文件
namePatternToInclude: "dm:today *.docx|*.xlsx"

3. 并行搜索优化

在GrepCore的Search方法中，通过SearchParams.SearchParallel控制并行度：

// 设置最大并行任务数
int maxParallel = GrepSettings.Instance.Get<int>(GrepSettings.Key.MaxDegreeOfParallelism);
ParallelOptions po = new() { 
    MaxDegreeOfParallelism = maxParallel == -1 ? -1 : Math.Max(1, maxParallel) 
};

4. 测试用例验证

GrepCoreTest中的测试用例验证了文件名筛选的准确性，例如：

// 测试通配符匹配
[Theory]
[InlineData(false)]
public void TestSearchPlainReturnsCorrectNumber(bool useLongPath)
{
    // ... 测试代码省略
    Assert.Single(results);  // 验证仅返回一个匹配文件
}

5. 配置模板复用

创建常用筛选配置模板，通过ConfigurationTemplate类保存：

// 保存为"源代码文件"模板
var template = new ConfigurationTemplate(
    "源代码文件", 
    new FileFilter(namePatternToInclude: "*.cs;*.vb;*.ts", isRegex: false)
);
ConfigurationManager.SaveTemplate(template);

常见问题与解决方案

Q1: 通配符与正则表达式模式冲突怎么办？

A: 当isRegex=true时，*会被解释为正则中的"任意字符"，如需匹配字面星号需转义\*。建议使用专用方法判断模式类型：

bool IsWildcardPattern(string pattern) => 
    pattern.Contains('*') || pattern.Contains('?');

Q2: 如何排除特定目录？

A: 通过NamePatternToExclude结合路径分隔符：

// 排除node_modules和bin目录
namePatternToExclude: @"*node_modules\*|*bin\*"

Q3: 大型项目搜索缓慢如何优化？

A: 启用三重加速机制：

useEverything=true（需安装Everything）
MaxSubfolderDepth=3（限制目录深度）
useGitignore=true（排除版本控制忽略文件）

总结与展望

dnGrep的文件名模式搜索功能通过FileFilter类的灵活配置，实现了从简单通配符到复杂正则表达式的全场景覆盖。无论是日常文件管理还是大型项目梳理，掌握这些技巧都能显著提升工作效率。随着v4.0版本的即将发布，预计将新增以下特性：

可视化正则表达式测试工具
保存搜索配置到快捷启动栏
与VS Code的文件导航集成

建议读者结合本文提供的代码示例和配置模板，构建适合自身需求的文件检索方案。如需进一步深入，可参考项目源代码中的GrepCore.cs和FileFilter.cs实现，或参与GitHub加速计划的贡献。

实用资源清单：

请收藏本文，并关注项目更新以获取最新功能教程。如有疑问或建议，欢迎在项目Issue区提交反馈。

【免费下载链接】dnGrep Graphical GREP tool for Windows 项目地址: https://gitcode.com/gh_mirrors/dn/dnGrep

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考