按键控制图片移动Python脚本故障：窗口未关与重复弹窗问题

存在的故障 #

• 图片移动/跳过操作完成后，当前图片窗口未关闭，直接打开下一张图片
• 跳过图片时会连续触发两次跳过逻辑，同时打开两张新图片，无法实现单张依次查看

故障原因 #

1. 图片窗口无法自动关闭：PIL的image.show()方法依赖系统默认图片查看器打开图片，但该方法不提供关闭窗口的接口，查看器进程会一直运行，导致窗口残留。
2. 按键重复读取：keyboard.read_key()会读取所有按键事件（包括按键释放），且如果之前有未处理的按键缓存，会被循环读取，导致一次按键触发多次循环迭代，出现连续跳过/打开多张图的问题。

修复方案 #

1. 主动控制图片查看器进程 #

放弃使用image.show()，改用subprocess调用系统图片查看器，获取进程句柄后，在处理完当前图片时主动终止进程，实现窗口关闭。

2. 优化按键读取逻辑 #

• 只监听按键按下事件，忽略按键释放事件，避免一次按键触发两次读取
• 读取按键前清空按键缓存，防止残留事件干扰

修改后的完整代码 #

import os
import shutil
import keyboard
import subprocess
import platform

# 配置文件夹路径，请替换为实际路径
image_folder = '/path/to/source/images/'
clean_folder = '/path/to/destination/clean/'
vehicle_folder = '/path/to/destination/vehicle/'
dirty_folder = '/path/to/destination/dirty/'

# 过滤出图片文件（支持常见格式）
valid_extensions = ('.jpg', '.jpeg', '.png', '.bmp', '.gif')
image_files = sorted(
    [f for f in os.listdir(image_folder) if f.lower().endswith(valid_extensions)]
)

def open_image(path):
    """跨平台打开图片并返回进程对象"""
    if platform.system() == 'Windows':
        return subprocess.Popen(['start', '', path], shell=True)
    elif platform.system() == 'Darwin':  # macOS
        return subprocess.Popen(['open', path])
    else:  # Linux
        return subprocess.Popen(['xdg-open', path])

for filename in image_files:
    src_path = os.path.join(image_folder, filename)
    print(f"当前图片: {filename}")
    print("按键说明：'c'→Clean文件夹，'v'→Vehicle文件夹，'d'→Dirty文件夹，'q'→退出，其他键→跳过")

    # 打开图片并记录进程
    image_process = open_image(src_path)

    # 等待有效按键（仅处理按下事件）
    pressed_key = None
    while pressed_key is None:
        event = keyboard.read_event()
        if event.event_type == keyboard.KEY_DOWN:
            pressed_key = event.name

    # 关闭图片查看器进程
    image_process.terminate()
    try:
        # 等待进程终止，超时则强制杀死
        image_process.wait(timeout=2)
    except subprocess.TimeoutExpired:
        image_process.kill()

    # 处理按键逻辑
    if pressed_key == 'q':
        print("退出程序...")
        break
    elif pressed_key in ('c', 'v', 'd'):
        # 选择目标文件夹
        dst_folder = {
            'c': clean_folder,
            'v': vehicle_folder,
            'd': dirty_folder
        }[pressed_key]
        # 移动文件
        shutil.move(src_path, os.path.join(dst_folder, filename))
        print(f"已移动至: {dst_folder}\n")
    else:
        print("跳过当前图片...\n")

print("图片分类完成。")

代码修改说明 #

• 新增open_image函数，实现跨平台调用系统图片查看器，并返回进程对象，方便后续关闭
• 使用keyboard.read_event()监听按键按下事件，确保一次按键只被读取一次
• 每次处理完图片后，主动终止图片查看器进程，解决窗口残留问题
• 增加图片格式过滤，避免非图片文件被处理
• 用字典简化目标文件夹的选择逻辑，代码更简洁

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