Python开发一键清理系统垃圾小工具示例代码详解(跨平台)

原创 2025-06-03 10:02:02编程技术

834

本文将通过Python实现一个跨平台的系统垃圾清理工具，支持清理临时文件、浏览器缓存、回收站/垃圾箱、日志文件等常见垃圾类型。代码包含详细注释和异常处理，适合初学者学习系统文件操作和自动化脚本编写。

一、项目概述

功能清单：

清理系统临时文件（temp目录）
清空回收站/垃圾箱（Windows/Linux/macOS）
删除浏览器缓存（Chrome/Firefox/Edge）
清理日志文件（/var/log或C:\Windows\Logs）
自定义清理目录（通过配置文件扩展）

技术亮点：

跨平台兼容（Windows/Linux/macOS）
安全删除（使用send2trash库避免数据丢失）
交互式确认机制
清理进度可视化

二、代码实现（分模块详解）

1. 基础配置与跨平台适配

import os
import platform
import shutil
from send2trash import send2trash  # 安全删除文件

# 跨平台路径配置
SYSTEM = platform.system()
CONFIG = {
    "temp_dirs": [
        os.environ.get("TEMP") or "/tmp",  # Windows/Linux临时目录
        os.path.expanduser("~/.cache")     # 用户缓存目录
    ],
    "log_dirs": [
        "/var/log" if SYSTEM != "Windows" else r"C:\Windows\Logs",
        os.path.expanduser("~/Library/Logs")  # macOS日志目录
    ],
    "browser_cache": {
        "chrome": {
            "Windows": os.path.expandvars(r"%LOCALAPPDATA%\Google\Chrome\User Data\Default\Cache"),
            "Linux": os.path.expanduser("~/.config/google-chrome/Default/Cache"),
            "Darwin": os.path.expanduser("~/Library/Application Support/Google/Chrome/Default/Cache")
        },
        # 可扩展Firefox/Edge等浏览器路径
    }
}

代码解析：

使用platform.system()自动检测操作系统
通过os.environ和os.path.expanduser获取系统目录
send2trash库替代os.remove，避免误删风险

2. 核心清理函数

def clear_directory(path, confirm=True):
    """清理指定目录下的所有文件和子目录"""
    if not os.path.exists(path):
        print(f"路径不存在: {path}")
        return

    if confirm:
        user_input = input(f"确定要清理 {path} 吗？(y/n): ").lower()
        if user_input != "y":
            print("操作已取消")
            return

    total_size = 0
    for root, dirs, files in os.walk(path):
        # 跳过隐藏目录（如Linux下的.git）
        dirs[:] = [d for d in dirs if not d.startswith('.')]
        
        for file in files:
            file_path = os.path.join(root, file)
            try:
                size = os.path.getsize(file_path)
                total_size += size
                send2trash(file_path)
                print(f"已删除: {file_path} ({size/1024:.2f}KB)")
            except Exception as e:
                print(f"删除失败 {file_path}: {str(e)}")

    print(f"清理完成，共释放 {total_size/1024/1024:.2f}MB 空间")

def empty_recycle_bin():
    """清空回收站/垃圾箱"""
    if SYSTEM == "Windows":
        # 使用Windows原生命令
        os.system('powershell.exe Clear-RecycleBin -Force -ErrorAction Ignore')
    else:
        # Linux/macOS通过发送到垃圾箱处理
        trash_path = os.path.expanduser("~/.local/share/Trash")
        if os.path.exists(trash_path):
            clear_directory(trash_path, confirm=False)

代码解析：

clear_directory函数实现递归清理，支持交互确认
使用生成器表达式优化目录遍历性能
通过send2trash实现跨平台安全删除
针对不同系统调用原生回收站清理命令

3. 主程序逻辑

def main():
    print("=== 系统垃圾清理工具 v1.0 ===")
    print(f"检测到操作系统: {SYSTEM}")

    # 清理系统临时文件
    print("\n[1] 清理临时文件...")
    for temp_dir in CONFIG["temp_dirs"]:
        if os.path.exists(temp_dir):
            clear_directory(temp_dir)

    # 清空回收站
    print("\n[2] 清空回收站...")
    empty_recycle_bin()

    # 清理浏览器缓存（示例：Chrome）
    print("\n[3] 清理浏览器缓存...")
    browser = "chrome"
    if browser in CONFIG["browser_cache"]:
        cache_path = CONFIG["browser_cache"][browser].get(SYSTEM)
        if cache_path and os.path.exists(cache_path):
            clear_directory(cache_path)

    # 清理日志文件
    print("\n[4] 清理日志文件...")
    for log_dir in CONFIG["log_dirs"]:
        if os.path.exists(log_dir):
            clear_directory(log_dir, confirm=False)  # 日志文件直接删除

    print("\n=== 清理完成 ===")

if __name__ == "__main__":
    main()