# TreeMap工具

**Repository Path**: chaoxi6888/file-stats-visualization-tool

## Basic Information

- **Project Name**: TreeMap工具
- **Description**: 这是一个linux系统，使用qt开发的小工具，可以对文件夹的代码和文件进行统计，并可视化输出，可选择保存结果到指定文件夹
- **Primary Language**: QML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-18
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

一个基于Qt开发的高性能文件夹统计工具，可递归扫描目录结构，统计文件数量、类型分布及源代码行数，并通过可视化图表展示结果。

# 功能特性
📂 递归扫描指定目录及其子目录

📊 统计文件数量、目录数量和源代码行数

🍰 可视化文件类型分布（饼图）

⏳ 实时显示扫描进度

⏹️ 支持中途取消扫描任务

💾 导出统计结果和图表为文本和图片文件

🚀 多线程设计，扫描不阻塞UI

# 技术栈
核心框架: Qt 5.15+

编程语言: C++11

# 关键技术:

Qt多线程(QThread)

Qt图表(QtCharts)

文件系统操作(QFile, QDir)

原子操作(std::atomic)

信号槽机制

# 构建与运行
### 环境要求
Qt 5.15或更高版本

C++11兼容编译器

CMake 3.5+ (可选)

# 构建步骤
使用qmake 
```
qmake
make
```

使用CMake

```
bash
mkdir build
cd build
cmake ..
make
```

运行程序

```
bash
./FolderStats
```

# 使用说明

1.在输入框中输入要扫描的目录路径

2.点击"确认"按钮开始扫描

3.扫描过程中：

    可实时查看已扫描文件数

    可点击"取消"按钮中止扫描

4.扫描完成后：

    自动弹出结果窗口显示统计信息

    可点击"保存结果"导出统计数据和图表

# 项目结构

```
text
FolderStats/
├── countui.h/cpp      # 主界面实现
├── directoryscanner.h/cpp # 目录扫描核心逻辑
├── main.cpp           # 程序入口
└── README.md          # 项目说明文档

```
# 许可证
本项目采用 MIT License。