ReadFolder

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #typescript #rust #deep-learning #linux #macos #java #cli #awesome-list #ios #openai #open-source

(★ 22)

快速查看文件夹/子文件夹的内容 | Quickly view the contents of a folder/subfolder

ReadFolder 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ReadFolder-文件夹阅读工具

<a href="README_EN.md">English</a>

文件夹阅读工具：
可以快速预览文件夹及其所有子目录中的所有文件

<a href="https://github.com/BlackCoder0/ReadFolder/releases">下载</a> ·
 <a href="#功能概览">功能概览</a> ·
 <a href="#界面预览">界面预览</a> ·
 <a href="#使用说明">使用说明</a> ·
 <a href="#键盘快捷键">键盘快捷键</a>

---

## 功能概览

- **递归扫描** — 自动遍历选定目录及全部子目录
- **目录树联动** — 左侧目录树与右侧内容区联动，点击树节点即可定位到对应分组
- **分组总览** — 右侧按目录分组展示内容，每个分组可独立展开 / 折叠
- **四种视图** — 超大图标 / 大图标 / 中图标 / 列表，适应不同浏览场景
- **多字段排序** — 按名称、修改时间、大小、类型、路径排序，支持升序 / 降序切换
- **类型筛选** — 按文件夹、图片、视频、音频、文档、PDF、文本/代码、压缩包、可执行文件等类别过滤
- **实时搜索** — 支持按文件名、扩展名、完整路径搜索，文本/代码文件还会匹配预览摘要内容
- **缩略图预览与缓存** — 自动为图片、视频等文件生成缩略图，缓存到本地磁盘，下次打开更快
- **文本内容预览** — 文本和代码文件显示前几行内容摘要，鼠标悬停即可看到
- **拖拽打开** — 直接把文件夹从资源管理器拖进窗口即可开始扫描
- **拖出文件** — 把文件卡片从窗口拖到桌面或其他应用，自动复制文件
- **右键文件操作** — 支持打开、资源管理器定位、复制、复制路径、粘贴、重命名、移动、复制到、删除和属性
- **多选批量操作** — 支持 `Ctrl` 点选、`Shift` 范围选择，并对当前扫描根内的选中项目批量复制、移动和删除
- **系统剪贴板集成** — 支持 `Ctrl+C` / `Ctrl+X` / `Ctrl+V` 与资源管理器复制、剪切文件互通；外部剪贴板来源可粘贴到当前工作区
- **Enter 打开** — 鼠标悬停文件按 Enter，用系统默认程序打开
- **状态记忆** — 关闭时自动记住窗口位置/大小、视图模式、排序、筛选、上次文件夹路径，下次启动恢复
- **命令行启动** — 支持通过命令行传入路径，启动即扫描
- **双语界面** — 支持中文 / English 实时切换，无需重启

## 交互说明

| 操作 | 效果 |
|------|------|
| 单击左侧目录树节点 | 选中节点，右侧跳转到对应分组 |
| 单击右侧组头 `+` / `-` 按钮 | 展开 / 折叠分组 |
| 双击右侧组头标题 | 用资源管理器打开对应文件夹 |
| 双击文件卡片 | 用系统默认程序打开文件 |
| 右键文件卡片 | 打开文件操作菜单 |
| `Ctrl` + 单击文件卡片 | 添加 / 取消选中单个文件 |
| `Shift` + 单击文件卡片 | 选择从锚点到当前文件之间的可见项目 |
| 多选后右键已选中文件卡片 | 对选中项目执行批量复制 / 移动 / 删除等操作 |
| 鼠标悬停文件 + 按 `Enter` | 用系统默认程序打开文件 |
| 拖拽文件夹到窗口 | 开始扫描该文件夹 |
| 拖拽文件卡片到外部 | 将文件复制到目标位置（桌面 / 其他应用） |
| 调整窗口 / 切换视图 / 排序 | 关闭后自动记忆，下次启动恢复 |

## 界面预览

### 主界面

左侧目录树 + 右侧递归分组总览

### 搜索与筛选

搜索框支持实时过滤，类型下拉框可按类别筛选

### 右键菜单与文件操作

文件卡片右键菜单支持打开、定位、复制、复制路径、粘贴、重命名、移动、复制到、删除和查看属性

### 四种视图模式

工具栏右侧提供四种视图按钮，根据浏览场景自由切换：

| 视图 | 适合场景 |
|------|----------|
| 超大图标（默认） | 图片 / 视频文件夹，预览细节 |
| 大图标 | 常规浏览，平衡信息量与预览尺寸 |
| 中图标 | 快速概览大量文件 |
| 列表 | 按名称 / 大小 / 时间排序比较 |

| | |
|:--:|:--:|
| ![超大图标](https://raw.githubusercontent.com/BlackCoder0/ReadFolder/main/asset/screenshot-views-1.png) | ![大图标](https://raw.githubusercontent.com/BlackCoder0/ReadFolder/main/asset/screenshot-views-2.png) |
| 超大图标 | 大图标 |
| ![中图标](https://raw.githubusercontent.com/BlackCoder0/ReadFolder/main/asset/screenshot-views-3.png) | ![列表](https://raw.githubusercontent.com/BlackCoder0/ReadFolder/main/asset/screenshot-views-4.png) |
| 中图标 | 列表 |

</div>

## 下载

发行文件请从 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、文本/代码、压缩包、可执行文件
- 点击 **"清除筛选"** 恢复默认状态

### 视图切换

工具栏右侧提供四个视图按钮：

| 视图 | 预览尺寸 | 卡片尺寸 | 适合场景 |
|------|----------|----------|----------|
| 超大图标 | 250×250 | 275×415 | 图片 / 视频文件夹，预览细节 |
| 大图标 | 144×144 | 225×315 | 常规浏览 |
| 中图标 | 86×86 | 165×215 | 快速概览大量文件 |
| 列表 | 54×54 | 全宽行 | 按列比较名称、路径、时间、大小 |

### 排序

支持按以下字段排序，点击箭头按钮切换升序 / 降序：

- 名称
- 修改时间
- 大小
- 类型
- 路径

文件夹始终排在文件前面。

### 多选与批量操作

多选模式会在文件卡片左上角显示蓝色序号标签，方便确认批量操作范围

- 单击文件卡片会选中该项目，并清除之前的文件选择
- 按住 `Ctrl` 单击可添加或取消单个项目；按住 `Shift` 单击可选择从上次单击锚点到当前项目之间的可见项目
- 进入多选后，文件卡片左上角会显示蓝色序号标签，表示当前选择顺序；底部状态栏会显示已选择数量
- 多选状态下右键已选中的文件卡片，会对当前选中项目执行批量操作；右键未选中的文件卡片会切换为只选中该项目
- 多选支持 `复制`、`复制路径`、`移动到...`、`复制到...`、`删除`；`打开`、`在资源管理器中定位`、`重命名`、`属性` 仅支持单个项目
- 批量移动、复制和删除只允许操作当前扫描根目录内仍然存在的项目；不能同时操作父文件夹及其子项目
- 批量复制 / 移动前会检查目标同名冲突，发现冲突会在预览里列出并取消执行，避免部分成功、部分失败
- 从系统剪贴板粘贴进工作区时，来源可以来自资源管理器或其他位置；目标必须是当前可用的工作区目录

## 键盘快捷键

| 快捷键 | 功能 |
|--------|------|
| `Enter` | 打开鼠标悬停位置的文件（搜索框聚焦时除外） |
| `F5` | 重新扫描当前目录 |
| `Ctrl + F` | 聚焦搜索框并全选已有文本 |
| `Ctrl + C` | 复制当前选中文件 |
| `Ctrl + X` | 剪切当前选中文件 |
| `Ctrl + V` | 粘贴剪贴板中的文件到当前选中目录或当前浏览目录 |

## 支持的文件类型

程序根据扩展名自动归类，支持的类别包括：

| 类别 | 常见扩展名 |
|------|-----------|
| 图片 | `.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 单文件程序的正常现象，后续启动更快
- 超大目录（十万级以上文件）扫描耗时较长；百万级文件不建议使用
- 部分文件格式无法生成缩略图，此时会显示类型图标
- 文件被其他程序占用时，预览或缩略图操作可能失败
- 文本预览与缩略图生成受文件权限和格式支持情况影响

## 许可证

本项目采用 [GNU General Public License v3.0](LICENSE) 开源。

---

Made by <a href="https://github.com/BlackCoder0">BlackCoder0</a>

ReadFolder

ReadFolder 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ReadFolder

ReadFolder 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README