指定扩展名文件过滤迁移脚本报错排查及修正需求

常见报错原因 #

• 路径无效：input.txt里的文件路径可能拼写错误、文件已被删除，或者路径包含空格/特殊字符但读取时未正确处理（比如Windows路径里的空格没被转义，导致脚本识别不完整）
• 目标目录不存在：跨目录移动文件时，shutil.move要求目标目录必须存在，否则会触发找不到路径的错误
• 权限不足：脚本运行用户没有源文件的读取权限，或者目标目录的写入权限
• 文件被占用：源文件正在被其他程序（如编辑器、播放器）打开，导致无法读取或移动

完整实现代码 #

以下代码实现了过滤指定扩展名文件、迁移并重命名、更新input.txt移除已处理路径的需求，同时包含错误处理：

import os
import shutil

# 配置参数，根据需求修改
TARGET_EXT = '.txt'       # 需要过滤的文件扩展名
DEST_DIR = './processed'  # 文件迁移的目标目录
INPUT_FILE = 'input.txt'  # 源路径记录文件
OUTPUT_FILE = 'output.txt'# 已迁移路径记录文件

# 确保目标目录存在，不存在则创建
os.makedirs(DEST_DIR, exist_ok=True)

# 读取input.txt中的所有路径，过滤空行
with open(INPUT_FILE, 'r', encoding='utf-8') as f:
    all_file_paths = [line.strip() for line in f if line.strip()]

success_moved = []
failed_moved = []

# 处理符合条件的文件
with open(OUTPUT_FILE, 'a', encoding='utf-8') as out_file:
    for file_path in all_file_paths:
        # 先检查文件是否存在
        if not os.path.isfile(file_path):
            failed_moved.append(file_path)
            print(f"跳过：文件不存在 -> {file_path}")
            continue
        
        # 检查扩展名是否匹配（忽略大小写）
        file_ext = os.path.splitext(file_path)[1].lower()
        if file_ext != TARGET_EXT.lower():
            continue
        
        # 生成迁移后的文件名：原文件名 + .processed + 原扩展名（例如test.txt → test.processed.txt）
        # 如果要替换原扩展名为.processed，可改成：new_name = f"{os.path.splitext(os.path.basename(file_path))[0]}.processed"
        original_name = os.path.basename(file_path)
        name, ext = os.path.splitext(original_name)
        new_name = f"{name}.processed{ext}"
        dest_full_path = os.path.join(DEST_DIR, new_name)
        
        try:
            # 移动并重命名文件
            shutil.move(file_path, dest_full_path)
            # 记录已迁移的路径到output.txt
            out_file.write(f"{dest_full_path}\n")
            success_moved.append(file_path)
            print(f"成功迁移：{file_path} → {dest_full_path}")
        except Exception as e:
            failed_moved.append(file_path)
            print(f"迁移失败：{file_path}，错误信息：{str(e)}")

# 更新input.txt：只保留未成功迁移的文件路径
with open(INPUT_FILE, 'w', encoding='utf-8') as f:
    for path in all_file_paths:
        if path not in success_moved:
            f.write(f"{path}\n")

# 输出最终结果
if failed_moved:
    # 可选：记录失败的文件路径到failed.txt
    with open('failed.txt', 'w', encoding='utf-8') as f:
        for path in failed_moved:
            f.write(f"{path}\n")
    print(f"\n处理完成，共{len(failed_moved)}个文件迁移失败，详情查看failed.txt")
else:
    print("\n所有符合条件的文件均成功迁移")

代码关键点说明 #

1. 目录预创建：用os.makedirs(DEST_DIR, exist_ok=True)确保目标目录存在，避免迁移时因目录不存在报错
2. 路径有效性检查：先判断文件是否存在，跳过无效路径，减少报错
3. 扩展名不区分大小写：转成小写后匹配，兼容不同大小写的扩展名（如.TXT和.txt）
4. 异常捕获：用try-except处理移动时的意外情况（比如权限不足、文件占用），避免脚本崩溃
5. input.txt更新：只保留未成功处理的路径，实现迁移后已处理路径从input.txt移除的需求
6. 失败记录：可选生成failed.txt，方便后续排查未迁移成功的文件

内容的提问来源于stack exchange，提问作者user4948798