批量文件MIME类型检测与分类整理工具：一键扫描目录检测文件类型、分类统计可视化、自动归类整理、导出CSV报告

🖥️ 运行效果

🚀 实例简介

一键扫描任意目录，自动检测所有文件的MIME类型（图片/视频/音频/文档/压缩包/代码等），按分类统计数量与大小，彩色条形图可视化展示分布。支持一键将文件按类型归类到子目录，支持导出CSV检测报告。整理杂乱文件夹、清理磁盘、数据迁移前分析文件组成的必备工具。

💻 核心代码

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
批量文件MIME类型检测与分类整理工具
功能：扫描目录检测所有文件MIME类型、分类统计、饼图可视化、自动分类整理、导出CSV报告
作者：好例子网 www.haolizi.com
"""

import os
import sys
import csv
import mimetypes
import platform
import tkinter as tk
from tkinter import ttk, filedialog, messagebox
from collections import Counter
from datetime import datetime

# 中文字体配置
CHINESE_FONT = "WenQuanYi Zen Hei" if platform.system() == "Linux" else "Microsoft YaHei"

# MIME类型到大类的映射
MIME_CATEGORIES = {
    "image": "🖼️ 图片",
    "video": "🎬 视频",
    "audio": "🎵 音频",
    "text": "📄 文本",
    "application/pdf": "📕 PDF文档",
    "application/zip": "📦 压缩包",
    "application/x-tar": "📦 压缩包",
    "application/gzip": "📦 压缩包",
    "application/json": "📋 数据文件",
    "application/xml": "📋 数据文件",
    "application/javascript": "💻 代码文件",
    "application/octet-stream": "⚙️ 二进制",
}


def get_mime_category(mime_type: str) -> str:
    """根据MIME类型返回分类名称"""
    if not mime_type or mime_type == "application/octet-stream":
        return "⚙️ 其他"
    if mime_type in MIME_CATEGORIES:
        return MIME_CATEGORIES[mime_type]
    major = mime_type.split("/")[0]
    return MIME_CATEGORIES.get(major, "⚙️ 其他")


def detect_mime_type(file_path: str) -> str:
    """检测文件的MIME类型（优先用python-magic，回退到mimetypes）"""
    try:
        import magic
        return magic.from_file(file_path, mime=True)
    except ImportError:
        mime, _ = mimetypes.guess_type(file_path)
        return mime or "application/octet-stream"


def scan_directory(directory: str) -> list:
    """递归扫描目录，返回文件信息列表"""
    results = []
    for root, dirs, files in os.walk(directory):
        dirs[:] = [d for d in dirs if not d.startswith(".")]
        for fname in files:
            if fname.startswith("."):
                continue
            fpath = os.path.join(root, fname)
            try:
                stat = os.stat(fpath)
                mime = detect_mime_type(fpath)
                category = get_mime_category(mime)
                results.append({
                    "path": fpath,
                    "name": fname,
                    "size": stat.st_size,
                    "mime": mime,
                    "category": category,
                    "modified": datetime.fromtimestamp(stat.st_mtime).strftime("%Y-%m-%d %H:%M"),
                })
            except (OSError, PermissionError):

💡 适用场景

办公自动化、数据分析、快速原型开发