# ReadFolder
**Repository Path**: code-liang/ReadFolder
## Basic Information
- **Project Name**: ReadFolder
- **Description**: 快速查看文件夹/子文件夹的内容 | Quickly view the contents of a folder/subfolder
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ReadFolder-文件夹阅读工具
文件夹阅读工具：
可以快速预览文件夹及其所有子目录中的所有文件
下载 ·
功能概览 ·
界面预览 ·
使用说明 ·
键盘快捷键
---
## 功能概览
- **递归扫描** — 自动遍历选定目录及全部子目录
- **目录树联动** — 左侧目录树与右侧内容区联动，点击树节点即可定位到对应分组
- **分组总览** — 右侧按目录分组展示内容，每个分组可独立展开 / 折叠
- **四种视图** — 超大图标 / 大图标 / 中图标 / 列表，适应不同浏览场景
- **多字段排序** — 按名称、修改时间、大小、类型、路径排序，支持升序 / 降序切换
- **类型筛选** — 按文件夹、图片、视频、音频、文档、PDF、文本/代码、压缩包、可执行文件等类别过滤
- **实时搜索** — 支持按文件名、扩展名、完整路径搜索，文本/代码文件还会匹配预览摘要内容
- **缩略图预览与缓存** — 自动为图片、视频等文件生成缩略图，缓存到本地磁盘，下次打开更快
- **文本内容预览** — 文本和代码文件显示前几行内容摘要，鼠标悬停即可看到
- **拖拽打开** — 直接把文件夹从资源管理器拖进窗口即可开始扫描
- **命令行启动** — 支持通过命令行传入路径，启动即扫描
- **双语界面** — 支持中文 / English 实时切换，无需重启
## 交互说明
| 操作 | 效果 |
|------|------|
| 单击左侧目录树节点 | 选中节点，右侧跳转到对应分组 |
| 单击右侧组头 `+` / `-` 按钮 | 展开 / 折叠 |
| 双击右侧组头标题 | 用资源管理器打开对应文件夹 |
| 双击文件卡片 | 用资源管理器 / 系统默认程序打开文件 |
| 拖拽文件夹到窗口 | 开始扫描该文件夹 |
## 界面预览
### 主界面
左侧目录树 + 右侧递归分组总览
### 搜索与筛选
搜索框支持实时过滤，类型下拉框可按类别筛选
### 四种视图模式
工具栏右侧提供四种视图按钮，根据浏览场景自由切换：
| 视图 | 适合场景 |
|------|----------|
| 超大图标（默认） | 图片 / 视频文件夹，预览细节 |
| 大图标 | 常规浏览，平衡信息量与预览尺寸 |
| 中图标 | 快速概览大量文件 |
| 列表 | 按名称 / 大小 / 时间排序比较 |
| | |
|:--:|:--:|
|  |  |
| 超大图标 | 大图标 |
|  |  |
| 中图标 | 列表 |
## 下载
发行文件请从 GitHub Releases 获取：
**[GitHub Releases](https://github.com/BlackCoder0/ReadFolder/releases)**
Releases 中通常提供两种文件：
- `ReadFolder.exe` — 便携版，下载后双击即可运行
- `ReadFolder-Setup-x.y.z.exe` — 安装版，支持自定义安装位置、注册为右键打开方式和系统卸载
## 使用说明
### 快速开始
1. 启动 `ReadFolder.exe` / 安装后双击打开
2. 点击 **"选择文件夹"**，或直接把文件夹拖进窗口
3. 等待扫描完成
4. 右侧会展示该目录及其子目录的递归总览，在左侧目录树中选择目录进入单独查看，
5. 双击文件用系统默认程序打开，双击文件夹用资源管理器打开
### 搜索与过滤
- 顶部搜索框输入关键词，即可按文件名、扩展名、路径和文本预览内容实时过滤
- 类型下拉框可过滤常见类别：文件夹、图片、视频、音频、文档、PDF、文本/代码、压缩包、可执行文件
- 点击 **"清除筛选"** 恢复默认状态
### 视图切换
工具栏右侧提供四个视图按钮：
| 视图 | 卡片尺寸 | 适合场景 |
|------|----------|----------|
| 超大图标 | 200×260 | 图片 / 视频文件夹，预览细节 |
| 大图标 | 160×210 | 常规浏览 |
| 中图标 | 120×170 | 快速概览大量文件 |
| 列表 | 全宽行 | 按列比较名称、路径、时间、大小 |
### 排序
支持按以下字段排序，点击箭头按钮切换升序 / 降序：
- 名称
- 修改时间
- 大小
- 类型
- 路径
文件夹始终排在文件前面。
## 键盘快捷键
| 快捷键 | 功能 |
|--------|------|
| `Ctrl + F` | 聚焦搜索框并全选已有文本 |
| `F5` | 重新扫描当前目录 |
## 支持的文件类型
程序根据扩展名自动归类，支持的类别包括：
| 类别 | 常见扩展名 |
|------|-----------|
| 图片 | `.jpg` `.png` `.gif` `.bmp` `.webp` `.svg` `.ico` 等 |
| 视频 | `.mp4` `.mkv` `.avi` `.mov` `.wmv` `.webm` 等 |
| 音频 | `.mp3` `.wav` `.flac` `.aac` `.ogg` `.m4a` 等 |
| 文档 | `.doc` `.docx` `.xls` `.xlsx` `.ppt` `.pptx` 等 |
| PDF | `.pdf` |
| 文本 | `.txt` `.md` `.log` `.csv` `.json` `.xml` `.ini` 等 |
| 代码 | `.cs` `.py` `.js` `.ts` `.java` `.cpp` `.h` `.html` `.css` `.rs` `.go` 等 |
| 压缩包 | `.zip` `.rar` `.7z` `.tar` `.gz` 等 |
| 可执行文件 | `.exe` `.dll` `.msi` `.bat` `.cmd` `.ps1` 等 |
> 未识别扩展名的文件归入"未知"类别，不影响浏览。
## 运行环境
- Windows 10 / 11 (x64)
## 注意事项
- 便携版首次启动稍慢，属于 self-contained 单文件程序的正常现象，后续启动更快
- 超大目录（十万级以上文件）扫描耗时较长；百万级文件不建议使用
- 部分文件格式无法生成缩略图，此时会显示类型图标
- 文件被其他程序占用时，预览或缩略图操作可能失败
- 文本预览与缩略图生成受文件权限和格式支持情况影响
## 许可证
本项目采用 [MIT License](../LICENSE) 开源。
---
Made by BlackCoder0