快速、精准的本地文件全文搜索工具
功能特性 • 快速开始 • 支持格式 • 使用指南 • 技术栈 • 项目结构
FullTXTLocal 是一款基于 Go + Wails 开发的本地文件全文搜索引擎桌面应用。类似 FullTXTLocalSearcher，可帮助您在电脑上的所有文件中快速搜索包含特定关键词的内容。
- ✅ 原生桌面应用：基于 Wails 2 构建，提供原生 Windows 体验
- ✅ 全文索引：基于 Bleve 2 的高效全文搜索引擎
- ✅ 实时监控：文件变更自动更新索引，无需手动干预
- ✅ 多格式支持：支持 Office 文档、PDF、代码文件等 30+ 种格式
- ✅ 轻量快速：启动迅速，搜索响应毫秒级
- ✅ 系统托盘：后台静默运行，不占用任务栏空间
- 高级搜索：智能分词，支持部分匹配（默认模式）
- 精确匹配：完整短语匹配，词语顺序不可颠倒
- 正则搜索：支持正则表达式，满足高级搜索需求
- 文件名权重：文件名匹配权重是内容的 2 倍，优先显示相关文件
- 自动索引：添加目录后自动扫描并建立索引
- 增量更新：文件变化自动触发索引更新（500ms 防抖）
- 目录管理：支持添加/移除多个索引目录
- 状态监控：实时显示索引进度和状态
- 文件预览：点击搜索结果即可查看文件内容预览
- 快速打开：使用系统默认程序一键打开文件
- 路径复制：点击即可复制文件路径到剪贴板
- 系统托盘：右键菜单快速访问，开机自启支持
- 下载可执行文件：
FullTXTLocal-v1.1.3.exe（约 22MB） - 双击运行：启动后自动打开主界面
- 添加索引目录：进入"索引目录管理"添加需要索引的文件夹
- 开始搜索：等待索引完成后即可搜索
| 类型 | 格式 |
|---|---|
| Office 文档 | .docx .xlsx .pptx |
| 文本文件 | .txt .md .csv .log .ini .yaml .yml .json .xml .toml .cfg .conf |
| 代码文件 | .go .py .js .ts .java .c .cpp .h .rs .php .rb .sh .sql .bat .ps1 |
| Web 文件 | .html .htm .css |
💡 文件大小限制：超过 10MB 的文件只读取前 10MB 内容
方法 ：通过界面
- 点击底部 「索引目录管理」 → 「展开」
- 粘贴文件夹路径或点击 「选择文件夹」 按钮
- 点击 「添加」，程序会自动扫描并建立索引
- 在顶部搜索框输入关键词
- 选择搜索模式：
- 高级搜索（默认）：智能分词，适合日常使用
- 精确匹配：完整短语匹配
- 正则搜索：支持正则表达式
- 按回车或点击 「搜索」 按钮
- 点击结果项：右侧显示文件预览
- 点击「打开」：使用系统默认程序打开文件
- 点击「复制」：复制文件路径到剪贴板
- 查看状态：展开「索引目录管理」查看总文件数和已索引数量
- 移除目录：点击目录右侧的 「移除」 按钮
- 重建索引：在目录管理区域点击重建按钮
默认索引存储在：%USERPROFILE%\.fulltxtlocal-go\bleve.db
指定到其他位置（如 D 盘）:
.\FullTXTLocal.exe -i D:\fulltxtlocal-index方法 1：放入启动文件夹
- 按
Win + R，输入shell:startup，回车 - 创建
FullTXTLocal.exe的快捷方式 - 右键快捷方式 → 属性 → 目标，添加参数
方法 2：使用任务计划程序
- 打开"任务计划程序"
- 创建基本任务 → 名称："FullTXTLocal"
- 触发器："当前用户登录时"
- 操作："启动程序" → 选择
FullTXTLocal.exe
删除 %USERPROFILE%\.fulltxtlocal-go\ 文件夹即可重置所有索引。
使用空格分隔多个关键词：
张三 花名册
→ 同时包含"张三"和"花名册"的文档
文件名匹配权重是内容的 2 倍：
- 搜索"报告" → 优先显示文件名包含"报告"的文档
- 搜索"2026 总结" → 优先显示文件名包含这些词的文档
| 模式 | 说明 | 示例 |
|---|---|---|
你好.*世界 |
匹配"你好"和"世界"之间的内容 | 你好，美丽的世界 |
\d{4}-\d{2}-\d{2} |
匹配日期格式 YYYY-MM-DD | 2026-01-15 |
\d+ |
匹配一个或多个数字 | 12345 |
[A-Za-z]+ |
匹配英文字母 | Hello |
| 模块 | 使用库 | 版本 |
|---|---|---|
| 桌面框架 | Wails v2 | 2.12.0 |
| 全文索引 | Bleve v2 | 2.5.7 |
| 文件监听 | fsnotify | 1.9.0 |
| PDF 解析 | ledongthuc/pdf | latest |
| Excel 解析 | excelize v2 | 2.10.1 |
| 系统托盘 | getlantern/systray | 1.2.2 |
| Word/PPT | 标准库 archive/zip + XML 解析 | - |
| 模块 | 使用库 | 版本 |
|---|---|---|
| 框架 | Vue 3 | 3.4.0 |
| 构建工具 | Vite | 5.0.0 |
| 通信 | Wails Runtime | 自动注入 |
- 后端：Go 1.25
- 前端：JavaScript (Vue 3 SFC)
A: 请确认：
- 已添加包含该关键词的文件夹到索引
- 索引状态显示"就绪"
- 尝试更换搜索模式（高级/精确/正则）
A: 首次索引大量文件时需要较长时间，这是正常的。后续会自动增量更新，速度会快很多。
A: 检查是否已运行 FullTXTLocal（查看系统托盘），或关闭占用 9922 端口的其他进程。
A: 查看项目目录下的日志文件：
error.log- 错误日志output.log- 输出日志run.log- 运行日志
A: 当前版本仅支持 Windows 10/11。如需跨平台支持，请查看 Wails 文档。
A: FullTXTLocal 仅支持文本型 PDF。扫描版 PDF（图片格式）无法提取文本内容，请使用 PDF 阅读器查看。
欢迎提交 Issue
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
- 作者：JasonMetal
- 产品版本：1.1.3
- 公司：FullTXTLocal
如果您觉得这个项目有用，请给一个 Star ⭐，这将是对我们最大的支持！
祝您使用愉快！ 🎉