从零搭建本地档案解压管理系统 完整实操落地指南

前置准备：环境与依赖安装

本系统基于Python实现，普通PC即可运行，要求Python版本≥3.8。

1. 安装Python：官网地址：https://www.python.org/downloads/，安装时务必勾选Add Python to PATH选项，避免后续路径问题。

2. 安装核心依赖：打开命令行（Windows按Win+R输入cmd，Mac/Linux打开终端），执行命令：pip install pyunpack patool，等待安装完成。

3. 安装系统级解压工具（否则无法处理RAR/7Z格式）：

• Windows：下载7-Zip，地址：https://www.7-zip.org/download.html，安装时勾选“Add 7-Zip to PATH”；
• Ubuntu/Debian：执行命令sudo apt update && sudo apt install unrar p7zip-full；
• CentOS：执行命令sudo yum install unrar p7zip p7zip-plugins。

项目结构搭建

新建本地文件夹作为项目根目录，命名为「档案解压系统」，目录下需包含4个核心内容：

• main.py：系统核心代码文件；
• source文件夹：存放待解压的档案压缩包；
• output文件夹：存放解压后的文件；
• 待处理压缩包：将需要解压的ZIP/RAR/7Z格式档案放入source文件夹。

核心代码编写

在项目根目录新建main.py，复制以下完整代码，无需修改，直接可用：

```python import os from datetime import datetime from pyunpack import Archive from patoolib import PatoolError 系统配置，无需调整 SOURCE = "./source" OUTPUT = "./output" ALLOWED_EXT = ('.zip', '.rar', '.7z', '.tar.gz') def init(): """初始化必要文件夹，不存在自动创建""" os.makedirs(SOURCE, exist_ok=True) os.makedirs(OUTPUT, exist_ok=True) print("系统初始化完成，待解压文件请放入source文件夹") def get_category(filename): """从压缩包文件名提取分类，格式为「分类-文件名.ext」""" name = os.path.splitext(filename)[0] return name.split('-')[0].strip() if '-' in name else "未分类" def extract(file_path): """单个压缩包解压逻辑，自动分类存放""" try: 生成带时间戳的解压路径，避免重名冲突 fname = os.path.basename(file_path) cat = get_category(fname) extract_path = os.path.join(OUTPUT, cat, f"{datetime.now().strftime('%Y%m%d%H%M%S')}_{fname}") os.makedirs(extract_path, exist_ok=True) 执行解压 Archive(file_path).extractall(extract_path) print(f"解压成功：{fname}") except PatoolError: print(f"解压失败{fname}：格式不支持或文件损坏") except Exception as e: print(f"解压失败{fname}：{str(e)}") def batch_process(): """批量处理source文件夹内的所有压缩包""" if not os.listdir(SOURCE): print("source文件夹为空，请放入压缩包") return for f in os.listdir(SOURCE): fp = os.path.join(SOURCE, f) if os.path.isfile(fp) and f.lower().endswith(ALLOWED_EXT): extract(fp) print("批量解压任务结束") if __name__ == "__main__": init() batch_process() ```

实操运行与验证

1. 启动系统

命令行进入项目根目录（比如Windows执行cd C:\Users\你的用户名\Desktop\档案解压系统），输入命令：python main.py，按回车运行。

2. 验证结果

查看output文件夹，系统会自动按压缩包文件名前缀创建分类子文件夹，每个压缩包解压后生成带时间戳的文件夹，避免文件覆盖；source文件夹内的压缩包处理完成后不会被删除，可自行清理。

3. 异常排查

• 解压报错：检查是否安装对应系统级解压工具，Windows需确认7-Zip已添加到环境变量；
• 文件未解压：确认source文件夹内的文件为ZIP/RAR/7Z格式，无加密（本系统暂不支持加密压缩包）；
• 编码问题：文件名含特殊字符时，重命名为纯中文/英文/数字后重试。

扩展调整：自定义分类规则

若需调整分类逻辑，修改代码中的get_category函数即可：

示例：按文件大小分类（大于100MB为大文件，小于为小文件），替换原有get_category函数为：

```python def get_category(filename): """按文件大小分类，单位MB""" fp = os.path.join(SOURCE, filename) size_mb = os.path.getsize(fp) / (1024 1024) return "大文件" if size_mb > 100 else "小文件" ```

修改后重新运行main.py即可生效，适配不同的档案整理需求。