本文档提供了 fzf 内部架构的高层概述，解释了核心组件及其交互。有关用法和命令行选项的信息，请参阅概述。有关特定组件的详细实现，请参阅其各自的页面：终端系统、模糊匹配算法、输入处理。
fzf 构建于事件驱动架构之上，其核心组件通过事件进行通信。这种方法实现了非阻塞、响应迅速的界面，使 fzf 成为一种特别有效的交互式过滤器。
来源：src/core.go12-19 src/terminal.go229-397 src/options.go528-634
fzf 的组件通过一个名为 EventBox 的中央事件总线进行通信。事件流程记录在代码库注释中。
来源：src/core.go12-19 src/core.go294-516
| 组件 | 主要职责 | 主要功能 |
|---|---|---|
| EventBox | 事件管理和通信 | 异步事件调度、事件订阅 |
| Reader | 读取和处理输入 | 处理各种输入源（标准输入、文件、命令） |
| ChunkList | 存储和管理输入数据 | 高效数据分块、快照创建 |
| 匹配器 | 根据查询查找匹配项 | 模糊匹配、排序、过滤 |
| 模式 | 构建搜索模式 | 处理各种搜索模式（模糊、精确） |
| 终端 | UI 渲染和用户输入 | 按键处理、显示格式化、预览窗口 |
| 选项 | 配置 | 存储所有用户指定的选项 |
来源：src/terminal.go229-397 src/options.go528-634
下图显示了数据在 fzf 系统中的流动情况。
fzf 采用修订系统来跟踪输入数据和查询处理的变化。这确保了 UI 始终显示一致的结果，即使在输入流式传输或变化时也是如此。
来源：src/core.go21-37 src/core.go198-222
fzf 的初始化和执行序列由 Run 函数管理。
来源：src/core.go40-60 src/core.go149-166 src/core.go287-516
Run 函数的主循环负责核心事件协调，它处理来自不同组件的事件。
终端组件是 fzf 中最复杂的部分，负责处理用户交互和显示渲染。它管理
终端组件为界面的不同部分（输入、预览、列表等）管理多个窗口，并处理用户配置定义的按键映射操作。
来源：src/terminal.go229-397 src/terminal.go787-1069
匹配器执行核心的模糊匹配功能，接收输入项并为用户的查询找到最佳匹配项。
读取器组件处理来自各种源的输入处理。
fzf 的行为可以通过其选项系统进行高度配置。
来源：src/options.go528-634 src/options.go650-734
fzf 的架构围绕异步、事件驱动的组件设计，使其能够提供响应迅速的界面，即使在处理大量数据时也是如此。输入处理（Reader）、匹配（Matcher）和用户界面（Terminal）之间的分离允许每个组件独立运行，同时通过中央 EventBox 进行协调。
这种设计促进了流式输入处理、实时模糊匹配和即时 UI 反馈等功能，使 fzf 成为强大的交互式过滤工具。