---

一、背景介绍：释放磁盘空间，提升系统性能

在日常使用Windows系统的过程中，我们常常会发现C盘空间被大量临时文件占据。这些文件通常由浏览器、办公软件、系统更新等程序生成，虽然在某些场景下是必要的，但长期堆积不仅占用磁盘空间，还可能影响系统运行效率，甚至导致程序异常。

手动清理这些临时文件既费时又容易遗漏，因此，开发一个自动化清理工具就显得尤为重要。本文将介绍如何使用Python编写一个自动清理C盘临时文件夹的实用工具，支持按时间、大小筛选，具备多线程处理和日志记录功能，帮助用户高效维护系统环境。

---

二、思路分析：从需求到实现

1. 功能需求

• 扫描C盘中的临时文件夹：如以 scoped_dir* 开头的文件夹；
• 支持按时间筛选：删除超过指定天数的文件夹；
• 支持按大小筛选：删除超过指定大小（如100MB）的文件夹；
• 多线程处理：提高清理效率；
• 命令行交互：用户可通过参数控制清理策略；
• 日志记录：记录清理过程，便于追踪和审计。

2. 技术选型

• Python 标准库：os, shutil, argparse, threading, datetime, logging；
• 无需第三方库：确保工具在任何Python环境中都能运行；
• 跨平台适配：虽然本文示例针对Windows，但代码结构可适配其他系统。

3. 实现流程

1. 遍历目标目录：使用 os.walk() 递归扫描所有子目录；
2. 识别临时文件夹：通过文件夹名判断是否为临时文件夹；
3. 计算文件夹大小和年龄：使用 os.path.getsize() 和 os.path.getctime()；
4. 筛选符合条件的文件夹：根据时间或大小判断是否删除；
5. 多线程删除：使用 ThreadPoolExecutor 并发执行删除操作；
6. 日志记录：使用 logging 模块记录清理过程；
7. 命令行交互：通过 argparse 提供灵活的参数控制。

---

三、代码实现（Python）

import os
import shutil
import argparse
import datetime
import logging
import threading
from concurrent.futures import ThreadPoolExecutor
from pathlib import Path

# 配置日志记录
logging.basicConfig(filename='cleanup_log.txt', level=logging.INFO,
                    format='%(asctime)s - %(levelname)s - %(message)s')

class TempFolderCleaner:
    def __init__(self, target_dir, max_age_days=30, max_size_mb=100):
        """
        初始化清理工具

        :param target_dir: 要清理的目标目录
        :param max_age_days: 超过此天数的文件夹将被删除
        :param max_size_mb: 超过此大小（MB）的文件夹将被删除
        """
        self.target_dir = target_dir
        self.max_age_days = max_age_days
        self.max_size_mb = max_size_mb
        self.lock = threading.Lock()

    def is_temp_folder(self, folder_name):
        """检查文件夹是否为临时文件夹（以scoped_dir*开头）"""
        return folder_name.startswith('scoped_dir')

    def folder_age(self, folder_path):
        """计算文件夹的创建时间（以天为单位）"""
        folder_time = os.path.getctime(folder_path)
        folder_time = datetime.datetime.fromtimestamp(folder_time)
        return (datetime.datetime.now() - folder_time).days

    def folder_size(self, folder_path):
        """计算文件夹大小（单位：MB）"""
        total_size = 0
        for dirpath, _, filenames in os.walk(folder_path):
            for filename in filenames:
                total_size += os.path.getsize(os.path.join(dirpath, filename))
        return total_size / (1024 * 1024)

    def delete_folder(self, folder_path):
        """删除指定文件夹及其内容"""
        try:
            shutil.rmtree(folder_path)
            logging.info(f"成功删除文件夹: {folder_path}")
            print(f"✅ 删除成功: {folder_path}")
        except Exception as e:
            logging.error(f"删除失败: {folder_path} - {str(e)}")
            print(f"❌ 删除失败: {folder_path} - {str(e)}")

    def clean(self):
        """主清理逻辑"""
        if not os.path.exists(self.target_dir):
            print(f"❌ 目标目录不存在: {self.target_dir}")
            return

        print(f"🔍 正在扫描目录: {self.target_dir}")
        logging.info(f"正在扫描目录: {self.target_dir}")

        with ThreadPoolExecutor(max_workers=4) as executor:
            for root, dirs, _ in os.walk(self.target_dir):
                for dir_name in dirs:
                    if self.is_temp_folder(dir_name):
                        folder_path = os.path.join(root, dir_name)
                        folder_age_days = self.folder_age(folder_path)
                        folder_size_mb = self.folder_size(folder_path)

                        # 检查是否符合清理条件
                        if folder_age_days > self.max_age_days or folder_size_mb > self.max_size_mb:
                            logging.info(f"发现待删除文件夹: {folder_path}")
                            print(f"🗑️ 找到待删除文件夹: {folder_path}")
                            executor.submit(self.delete_folder, folder_path)

        print("✅ 清理完成，成功删除符合条件的文件夹。")
        logging.info("清理完成，成功删除符合条件的文件夹。")

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description='自动清理C盘临时文件夹工具')
    parser.add_argument('-d', '--directory', required=True, help='要清理的目录路径')
    parser.add_argument('-t', '--max-age-days', type=int, default=30,
                        help='最大保留天数（默认: 30）')
    parser.add_argument('-s', '--max-size-mb', type=int, default=100,
                        help='最大保留大小（MB， 默认: 100）')
    parser.add_argument('-m', '--multi-thread', action='store_true',
                        help='启用多线程清理（默认: 单线程）')

    args = parser.parse_args()

    cleaner = TempFolderCleaner(args.directory, args.max_age_days, args.max_size_mb)
    cleaner.clean()

---

四、项目结构与运行说明

1. 目录结构示例：

cleanup_temp/
│
├── cleanup_temp.py
└── cleanup_log.txt

2. 运行环境要求：

• 操作系统：Windows（适用于C盘临时文件清理）；
• Python 版本：3.8 及以上；
• 依赖库：仅使用Python标准库；
• 运行方式：
  bash
python cleanup_temp.py -d C:\Users\user\AppData\Local\Temp -t 30 -s 100 -m

3. 注意事项：

• 管理员权限：部分系统目录需要管理员权限才能删除；
• 路径合法性：确保输入路径为合法路径，避免误删重要文件；
• 先查看日志：建议首次运行时先查看 cleanup_log.txt，确认清理内容后再执行删除操作。

---

五、学习价值与扩展建议

学习价值：

• 文件系统操作：掌握如何使用Python操作文件和目录；
• 条件判断与筛选：学习如何根据时间、大小等条件筛选文件；
• 多线程处理：了解如何使用 ThreadPoolExecutor 提高处理效率；
• 日志记录机制：掌握 logging 模块的基本使用方法；
• 命令行交互设计：学习如何使用 argparse 实现灵活的参数控制。

扩展建议：

• 支持更多命名规则：如 tmp*, cache* 等；
• 支持图形界面：使用 tkinter 构建可视化清理工具；
• 定时任务功能：结合 schedule 模块实现定时自动清理；
• 支持文件类型过滤：清理特定扩展名的文件（如 .tmp, .log）；
• 支持回收站删除：在Windows中使用 send2trash 模块将文件移入回收站。

---

六、总结

本项目实现了一个基于Python的自动清理C盘临时文件工具，能够高效地识别并删除以 scoped_dir* 开头的临时文件夹，支持时间、大小筛选，并具备多线程处理和日志记录功能。该工具功能明确、结构清晰，适合中级以下开发者在1~3天内完成。

通过该项目，开发者可以掌握文件系统操作、条件筛选、多线程处理和日志记录等实用技能，为构建更复杂的系统维护工具打下坚实基础。同时，该项目也展示了如何将Python用于系统级任务自动化，提升工作效率，减少人工干预。

本文由AI大模型（电信天翼量子AI云电脑-云智助手-Qwen3-32B）结合行业知识与创新视角深度思考后创作。