# filesearch4j

**Repository Path**: zhonghanyc/filesearch4j

## Basic Information

- **Project Name**: filesearch4j
- **Description**: java桌面版文件搜索工具
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2025-12-20
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileSearch4J

FileSearch4J 是一个基于 Java Swing 开发的轻量级文件搜索工具。它支持在指定目录下通过文件名（模糊匹配或正则表达式）、时间范围（创建/修改）、文件大小、文件类型以及目录搜索来快速查找文件。

## ✨ 功能特性

*   **多模式搜索**：
    *   **模糊匹配**：默认按文件名包含的关键字搜索（不区分大小写）。
    *   **正则表达式**：支持使用 Java 正则表达式进行高级匹配。
    *   **按文件类型**：支持主流的文件类型和后缀，并包含可执行类文件分组。
    *   **按文件时间**：支持创建时间或修改时间，并可设置时间范围。
    *   **按文件大小**：支持大小范围与单位选择。
    *   **包含目录**：支持将目录作为搜索结果。
*   **异步处理**：搜索过程在后台线程运行，界面流畅不卡顿，且支持随时取消。
*   **结果详情**：结果列表中显示文件名、完整路径、文件大小、修改时间及创建时间。
*   **便捷操作**：支持双击“路径”列复制文件路径（只读模式，防止误改），并支持右键复制文件名。
*   **结果导出**：支持将搜索结果导出为 TXT 或 CSV。
*   **高性能遍历**：采用非递归栈（Stack）方式遍历目录，避免深层目录导致的栈溢出问题。

## 🛠️ 环境要求

*   **Java JDK**：1.8 或更高版本。
*   **Maven**：3.x（用于构建项目）。

## 🚀 如何构建

本项目使用 Maven 进行管理。在项目根目录下运行以下命令即可编译并打包：

```bash
mvn clean package
```

构建成功后，将在 `target` 目录下生成可执行的 JAR 文件：`filesearch4j-1.0-SNAPSHOT.jar`。

## ▶️ 如何运行

你可以通过以下两种方式运行程序：

### 方式 1：使用 Java 命令运行 JAR 包

```bash
java -jar target/filesearch4j-1.0-SNAPSHOT.jar
```

### 方式 2：使用 Maven 运行

```bash
mvn exec:java -Dexec.mainClass="com.filesearch.Main"
```

## 📖 使用说明

1.  **启动程序**：运行程序后，将看到主界面。
2.  **选择目录**：点击“选择目录”按钮，或直接粘贴路径到“目录”输入框中，指定搜索的根目录（默认当前工作目录）。
3.  **输入条件**：
    *   **搜索词**：输入要查找的文件名关键字。
    *   **正则表达式**：如果需要正则匹配，请勾选“使用正则表达式”。
    *   **时间范围(天)**：设置最小值和最大值，并选择“创建时间”或“修改时间”。
    *   **文件大小**：设置最小值和最大值，并选择单位（Byte/KB/MB/GB）。
    *   **文件类型**：选择类型分组进行过滤，勾选“包含目录”可将目录纳入结果。
4.  **开始搜索**：点击“搜索”按钮。
5.  **查看结果**：搜索结果将实时显示在下方列表中。
6.  **复制路径**：双击结果列表中的“路径”单元格，选中文本并按 `Ctrl+C` 即可复制。
7.  **导出结果**：点击“导出结果”，选择 TXT 或 CSV 保存。
8.  **取消搜索**：搜索过程中可随时点击“取消”按钮停止搜索。

## 📄 许可证

本项目采用 [GPL-3.0 许可证](LICENSE) 开源。