夜雨聆风
文件搜索工具 v1.4 使用说明书
文件搜索工具 v1.4 使用说明书
一、工具简介
本工具是一款基于Python开发的本地文件内容与文件名搜索工具，支持图形化操作，可快速定位包含指定关键词的文件，并支持导出搜索结果为CSV格式，兼容Office / WPS办公软件。
二、核心功能
-
可视化路径选择：通过「浏览」按钮选择目标文件夹，无需手动输入路径。 -
双重搜索模式：
o支持在文件内容中搜索关键词（仅对文本文件生效）。
o支持在文件名中搜索关键词（可独立或同时启用）。
3.灵活筛选：
o支持按文件类型筛选（如.txt、.py、.md 等），留空或输入 * 表示所有类型。
o支持区分大小写搜索。
4.结果查看与操作：
o双击结果可直接打开对应文件。
o右键菜单支持「查看完整行」（弹窗显示完整匹配内容并高亮关键词）和「打开文件」。
5.结果导出：支持将搜索结果导出为CSV文件，采用GBK编码，确保 Office / WPS 正常打开。
三、安装与运行
1. 运行环境
-
Windows 系统（已打包为独立 EXE，无需安装 Python 环境）。 -
双击运行 文件搜索工具.exe 即可启动。
2. 首次使用
-
启动后，界面分为「搜索路径」「搜索条件」「进度提示」「搜索结果」四个区域。 -
首次使用无需额外配置，直接按步骤操作即可。
四、操作步骤
步骤 1：选择搜索路径
-
点击「浏览」按钮，在弹出的对话框中选择要搜索的目标文件夹。 -
选择完成后，「目标路径」输入框会显示所选路径。
步骤 2：设置搜索条件
-
关键词：输入要搜索的内容（必填）。 -
文件类型：
o留空或输入 *：搜索所有文件类型。
o输入后缀（如 .txt .py）：仅搜索指定类型文件，多个类型用空格分隔。
3.区分大小写：勾选后，关键词匹配将区分大小写（默认不区分）。
4.同时搜索文件名：勾选后，工具会同时在文件名和文件内容中查找关键词（默认勾选）。
步骤 3：开始搜索
-
点击「开始搜索」按钮，工具会递归遍历目标路径下的所有文件。 -
进度提示区会实时显示：正在搜索：X 个文件 | 已匹配：Y 个文件。 -
搜索完成后，进度提示区会显示：搜索完成 | 总计：X 个文件 | 匹配：Y 个文件 | 匹配行数：Z。
步骤 4：查看与操作结果
-
双击打开文件：双击结果列表中的任意条目，可直接打开对应文件。 -
右键菜单：
o查看完整行：弹窗显示匹配行的完整内容，关键词会以黄色高亮显示。
o打开文件：与双击功能一致。
o导出所有结果到 CSV：将当前所有搜索结果导出为 CSV 文件。
步骤 5：导出结果（可选）
-
点击界面上方的「导出结果到 CSV」按钮，或右键菜单选择「导出所有结果到 CSV」。 -
在弹出的对话框中选择保存路径，默认文件名格式为 文件搜索结果_关键词.csv。 -
导出成功后，弹窗提示保存路径，并可选择「立即打开」导出的 CSV 文件。
五、常见问题
1. 搜索结果为空
·原因：
1.目标路径下没有包含关键词的文件。
2.文件类型筛选过严，导致未匹配到文件。
3.仅勾选了「区分大小写」，而文件中的关键词大小写与输入不一致。
·解决：
o检查关键词拼写是否正确。
o清空「文件类型」输入框，或输入 * 以搜索所有文件。
o取消勾选「区分大小写」。
2. CSV 文件乱码
·原因：使用了不支持 GBK 编码的软件打开。
·解决：使用 Office Excel 或 WPS 打开，这两款软件对 GBK 编码的 CSV 文件支持良好。
3. 工具运行缓慢
·原因：目标路径下文件数量过多，或文件过大。
·解决：
o缩小搜索范围，选择更具体的子文件夹。
o使用「文件类型」筛选，只搜索需要的文件类型。
六、注意事项
-
工具仅对文本文件（如 .txt、.py、.md 等）进行内容搜索，二进制文件（如 .exe、.rar、.pdf 等）会被跳过，避免乱码和程序崩溃。 -
导出的 CSV 文件采用 GBK 编码，确保 Office / WPS 正常打开，请勿使用记事本等纯文本编辑器直接打开，可能会出现乱码。 -
搜索过程中，若需终止搜索，可点击「清空结果」按钮，工具会在下一个文件处理时停止。
七、版本信息
·版本号：v1.4
·更新日期：2026 年
·更新内容：
o新增「导出结果到 CSV」功能，支持 GBK 编码。
o优化文件类型筛选逻辑，空值或 * 表示所有类型。
o增加「同时搜索文件名」选项，提升搜索范围。
o优化界面布局，提升操作体验。
