海关部门档案整理：Python批量重命名与归档实战

一、环境准备与依赖安装

海关档案整理涉及大量扫描件和电子文档，手动重命名效率极低。本方案使用Python进行自动化处理，无需复杂配置，直接上手。首先需要确保电脑已安装Python环境（建议版本3.8及以上）。若未安装，请前往Python官网下载安装包并运行安装，安装时务必勾选"Add Python to PATH"选项。

打开命令行工具（Win键+R输入cmd回车），输入以下命令安装处理Excel和文件所需的第三方库：

```bash pip install pandas openpyxl ```

该命令将安装pandas（用于读取档案索引表）和openpyxl（用于读写xlsx格式文件）。安装成功后，即可进入目录结构搭建阶段。

二、档案元数据映射表制作

自动化整理的核心在于建立“混乱文件名”与“规范档案名”的映射关系。我们利用Excel作为元数据源，因为它方便非技术人员维护。请在电脑D盘根目录下新建一个文件夹，命名为CustomsArchive，并在该文件夹内新建一个Excel文件，命名为index_mapping.xlsx。

打开index_mapping.xlsx，在第一行设置表头，依次填入：原始文件名、归档日期、档案类型、报关单号。这四列是脚本运行的关键依据。请根据实际待整理的文件情况填写数据，示例如下：

• 原始文件名：填写当前扫描件或电子文档的实际文件名（包含扩展名），例如 "IMG_20230501_001.jpg"。
• 归档日期：填写规范格式的日期，建议使用YYYYMMDD格式，例如 "20230501"。
• 档案类型：填写海关业务分类，例如 "进口报关单"、"合同"、"发票"。
• 报关单号：填写对应的业务编号，例如 "123456789"。

确保Excel文件保存后关闭，避免后续脚本读取时出现文件占用错误。

三、目录结构初始化

为了防止误操作导致原始文件丢失，必须严格遵循以下目录结构。在D:\CustomsArchive文件夹下，建立两个子文件夹：raw_files和organized_files。

• raw_files：存放所有待整理的、文件名混乱的原始档案（扫描件、PDF等）。请将所有需要处理的文件复制或剪切至此文件夹中。
• organized_files：这是空文件夹，用于存放脚本处理后的、已按规范重命名并分类的档案。

最终目录树结构应如下所示：

D:\CustomsArchive
├── index_mapping.xlsx
├── raw_files
│   ├── IMG_20230501_001.jpg
│   ├── scan002.pdf
│   └── ...
└── organized_files
(空文件夹)

四、自动化归档脚本开发

在D:\CustomsArchive目录下新建一个文本文件，将其重命名为archive_tool.py。右键点击该文件，选择“打开方式”->“记事本”或任意代码编辑器（如VS Code），粘贴以下完整代码。该脚本包含文件查找、重命名逻辑、自动创建分类子目录及异常处理机制。

```python import os import shutil import pandas as pd from datetime import datetime def organize_customs_files(): 定义基础路径，请根据实际情况修改，当前设定为D盘根目录下的CustomsArchive base_dir = r'D:\CustomsArchive' excel_path = os.path.join(base_dir, 'index_mapping.xlsx') source_dir = os.path.join(base_dir, 'raw_files') target_dir = os.path.join(base_dir, 'organized_files') 检查Excel文件是否存在 if not os.path.exists(excel_path): print(f"错误：未找到索引文件 {excel_path}") return 读取Excel数据 try: df = pd.read_excel(excel_path) 检查必要的列是否存在 required_columns = ['原始文件名', '归档日期', '档案类型', '报关单号'] for col in required_columns: if col not in df.columns: print(f"错误：Excel表中缺少必要的列：{col}") return except Exception as e: print(f"读取Excel文件失败: {e}") return success_count = 0 fail_count = 0 log_list = [] print("开始处理档案整理...") 遍历Excel每一行 for index, row in df.iterrows(): old_name = str(row['原始文件名']).strip() archive_date = str(row['归档日期']).strip() doc_type = str(row['档案类型']).strip() customs_no = str(row['报关单号']).strip() 原始文件完整路径 src_file_path = os.path.join(source_dir, old_name) 检查原始文件是否存在 if not os.path.exists(src_file_path): error_msg = f"未找到文件: {old_name}" print(error_msg) log_list.append(error_msg) fail_count += 1 continue 获取文件扩展名 file_ext = os.path.splitext(old_name)[1] 构建新文件名：日期_类型_单号.扩展名 替换文件名中的特殊字符，防止报错 safe_doc_type = doc_type.replace(' ', '_').replace('-', '_') new_file_name = f"{archive_date}_{safe_doc_type}_{customs_no}{file_ext}" 构建目标分类文件夹路径 category_folder = os.path.join(target_dir, safe_doc_type) if not os.path.exists(category_folder): os.makedirs(category_folder) dest_file_path = os.path.join(category_folder, new_file_name) 处理文件名重复问题 counter = 1 while os.path.exists(dest_file_path): name_part = os.path.splitext(new_file_name)[0] dest_file_path = os.path.join(category_folder, f"{name_part}_{counter}{file_ext}") counter += 1 移动并重命名文件 try: shutil.move(src_file_path, dest_file_path) success_msg = f"成功: {old_name} -> {new_file_name}" print(success_msg) log_list.append(success_msg) success_count += 1 except Exception as e: error_msg = f"移动失败 {old_name}: {e}" print(error_msg) log_list.append(error_msg) fail_count += 1 生成处理日志 log_file_path = os.path.join(base_dir, f"process_log_{datetime.now().strftime('%Y%m%d%H%M%S')}.txt") with open(log_file_path, 'w', encoding='utf-8') as f: f.write("\n".join(log_list)) f.write(f"\n\n处理完成。成功: {success_count}, 失败: {fail_count}") print(f"\n所有操作已完成。详细日志请查看: {log_file_path}") if __name__ == "__main__": organize_customs_files() ```

保存文件并退出编辑器。此脚本逻辑严密，首先校验Excel表头完整性，其次在源文件夹中查找对应文件，并自动根据“档案类型”在目标文件夹下创建子目录，最后按照“日期_类型_单号”的格式重命名文件。如果遇到重名文件，系统会自动在文件名后追加数字序号，防止覆盖。

五、执行与结果验证

回到命令行界面，确保当前路径在项目目录下，或直接使用绝对路径运行脚本。输入以下命令执行程序：

```bash python D:\CustomsArchive\archive_tool.py ```

脚本启动后，屏幕将实时滚动显示每一条文件的处理状态。若提示“未找到文件”，请检查raw_files文件夹中的文件名是否与Excel中的“原始文件名”列完全一致（注意空格和大小写）。处理完毕后，脚本会在D:\CustomsArchive目录下生成一个带时间戳的process_log_XXXX.txt日志文件，里面记录了所有成功和失败的详细信息。

打开organized_files文件夹，您将看到所有文件已按照“档案类型”自动归类到不同的子文件夹中，且文件名已统一为规范的业务格式。至此，海关部门档案的数字化整理工作全部完成，整个过程无需人工逐一干预，极大降低了出错率并提升了工作效率。