File Visualization 是一个使用 Rust 编写的文件结构可视化工具，旨在帮助用户快速查看文件夹内部结构与文件大小分布，支持可配置输出，专注于效率与清晰展示。
这是一个用于练习和探索文件系统结构分析的 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。