File Visualization

File Visualization 是一个使用 Rust 编写的文件结构可视化工具，旨在帮助用户快速查看文件夹内部结构与文件大小分布，支持可配置输出，专注于效率与清晰展示。

为什么选择 File Visualization？

这是一个用于练习和探索文件系统结构分析的 Rust 项目。目标是在终端中清晰、简洁地展示文件夹内部文件与目录的信息，可作为磁盘清理、项目体积分析等场景的辅助工具。

目前主要支持 Windows 环境，后续将逐步拓展兼容性与功能性。

用法

从最基础的命令开始，默认展示三级目录：

file-visualization                # 遍历当前目录，显示文件结构与大小
file-visualization <dir>         # 遍历指定目录

未来目标

我们计划逐步支持以下用法与功能：

用法: file-visualization
用法: file-visualization <dir> <dir2> ...
用法: file-visualization -p             # 显示完整路径
用法: file-visualization -s             # 显示文件长度而非磁盘占用空间
用法: file-visualization -n 30          # 限制输出数量，默认终端高度
用法: file-visualization -d 3           # 限制递归深度（默认值为3）
用法: file-visualization -D             # 仅显示目录
用法: file-visualization -F             # 仅显示文件，并找出最大的文件
用法: file-visualization -r             # 反向输出
用法: file-visualization -o si/b/kb/... # 设置大小单位（支持 SI 与二进制单位）
用法: file-visualization -X ignore      # 忽略名称为 ignore 的文件或文件夹
用法: file-visualization -x             # 限制在同一文件系统中
用法: file-visualization -b             # 不显示百分比或 ASCII 条形图
用法: file-visualization -B             # 百分比条移到右侧
用法: file-visualization -i             # 不显示隐藏文件
用法: file-visualization -c             # 禁用彩色输出
用法: file-visualization -C             # 强制启用彩色输出
用法: file-visualization -f             # 计算文件数量而非空间占用
用法: file-visualization -t             # 按文件类型分组
用法: file-visualization -z 10M         # 过滤小于指定大小的文件
用法: file-visualization -e regex       # 仅包含匹配正则的文件
用法: file-visualization -v regex       # 排除匹配正则的文件
用法: file-visualization -L             # 跟踪符号链接
用法: file-visualization -P             # 禁用进度条
用法: file-visualization -R             # 屏幕阅读器模式（无图形符号）
用法: file-visualization -S             # 设置自定义线程栈大小（解决栈溢出）
用法: file-visualization --skip-total   # 不显示总计行
用法: file-visualization -j             # 输出 JSON（可与 jq 配合使用）
用法: file-visualization --files0-from=FILE # 从 null 结尾的路径列表中读取
用法: file-visualization --collapse=xxx # 折叠指定目录（如 node_modules）

开发路线图

✅ 基础功能：遍历目录并统计大小
✅ CLI 参数支持（使用 clap）
🔄 路径过滤与正则匹配
🔄 更丰富的终端输出格式
🔄 JSON 输出、屏幕阅读器支持
🔄 可视化图形（ASCII 条形图或图表）

安装

使用 cargo 构建并运行：

git clone https://github.com/yourname/file-visualization.git
cd file-visualization
cargo run --release -- <your-options>

许可证

本项目使用 MIT License。

License

ztygod/file-visualization

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages