Python复制子文件夹字母排序首文件时总复制第二个文件的问题

你的脚本运行不符合预期，核心是两个没处理的常见坑：

• 只在注释里标注了需要先排序文件，实际没有执行排序操作。os.walk()返回的文件列表是操作系统读取目录项得到的原生顺序，和资源管理器里展示的字母排序结果完全无关，顺序本身也不稳定，直接切片取第一个元素，根本拿不到你预期的字母序首位文件。
• 没有过滤系统隐藏文件。Windows会自动在存放图片的目录下生成Thumbs.db缩略图缓存文件，这类文件默认是隐藏状态，你在资源管理器里看不到，但os.walk()会把它纳入文件列表，且按文件名排序时往往排在普通图片前面。你肉眼看到的第一张图片，实际在返回的文件列表里排第二位，自然会出现「复制了第二张图、第一张图被跳过」的现象。
• 额外逻辑隐患：原脚本用字符串replace做路径拼接，一旦源路径名刚好在子路径中出现重复字段，会拼出错误的目标路径。

import os
import shutil

p1 = r"D:\storage\source"
p2 = r"D:\storage\destination"
# 每个子文件夹需要保留的文件数量
N = 1
# 定义需要处理的图片后缀，可根据实际需求增减
valid_img_suffix = ('.jpg', '.jpeg', '.png', '.bmp', '.gif', '.webp')

for path, folders, files in os.walk(p1):
    # 如果不需要处理源目录根目录下的零散文件、仅处理子文件夹，打开下面两行注释即可
    # if path == p1:
    #     continue

    # 1. 过滤系统缓存文件、非目标格式文件
    # 2. 按文件名字母顺序（不区分大小写，和Windows资源管理器默认排序逻辑一致）排序
    sorted_files = sorted(
        [f for f in files if not f.lower().endswith('.db') and f.lower().endswith(valid_img_suffix)],
        key=str.lower
    )
    # 空文件夹直接跳过
    if not sorted_files:
        continue

    # 取排序后的前N个文件执行复制
    for file_ in sorted_files[:N]:
        src = os.path.join(path, file_)
        # 计算相对路径，拼接目标目录
        rel_path = os.path.relpath(path, p1)
        dst_folder = os.path.join(p2, rel_path)
        # 目标目录不存在则自动创建
        os.makedirs(dst_folder, exist_ok=True)
        dst = os.path.join(dst_folder, file_)
        shutil.copy2(src, dst)

• 新增两层文件过滤逻辑：自动跳过.db结尾的系统缓存文件，仅处理指定后缀的图片文件，避免无关文件占用排序位次
• 显式执行不区分大小写的字母排序，排序规则和Windows资源管理器默认逻辑对齐，保证取到的是你视觉确认的排序第一位的图片
• 改用os.path标准库方法做路径计算和拼接，替换原来的字符串replace逻辑，避免特殊场景下的路径拼接错误
• 用os.makedirs的exist_ok=True参数替代手动判断目录是否存在的逻辑，代码更简洁，也避免多线程/并发场景下的判断时序问题
• 预留了跳过源根目录文件的开关，可根据自己的需求选择是否开启

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