Python shutil.move移动文件无效果、文件存在跳过问题排查

移动操作无响应的核心原因 #

• 源文件路径拼接错误：代码中误将os.listdir(path1)返回的文件名列表file_dir作为路径参数传入os.path.join，os.listdir的返回值是包含目录下所有条目名称的列表，不是路径字符串，拼接逻辑完全错误，导致程序找不到待移动的源文件。
• 缺少执行反馈与异常处理：代码没有打印执行状态，遇到路径非法、权限不足、目标目录不存在这类错误时，无法直观感知报错信息，看起来就像“无任何输出”。

同名文件自动跳过的实现方法 #

遍历文件时，先拼接出当前文件对应的目标存储完整路径，用os.path.exists()判断该路径是否已存在文件：

• 若存在：直接用continue跳过当前文件，进入下一轮循环处理下一个条目
• 若不存在：再执行移动操作

修复后可直接运行的完整代码 #

import os
import shutil

# 源文件所在目录
source_dir = r"C:xxx"
# 文件移动目标目录
target_dir = r"C:xxx"

# 预检查：目标目录不存在则自动创建，避免移动报错
if not os.path.exists(target_dir):
    os.makedirs(target_dir)

# 遍历源目录下所有条目
for file_name in os.listdir(source_dir):
    # 筛选.jpg后缀的文件，兼容大写.JPG格式
    if file_name.lower().endswith('.jpg'):
        # 拼接源文件完整路径
        source_file_path = os.path.join(source_dir, file_name)
        # 跳过子目录、快捷方式等非文件条目，避免移动报错
        if not os.path.isfile(source_file_path):
            continue
        # 拼接目标文件完整路径
        target_file_path = os.path.join(target_dir, file_name)
        # 目标路径已存在同名文件，直接跳过
        if os.path.exists(target_file_path):
            print(f"跳过已存在文件：{file_name}")
            continue
        # 执行移动操作，捕获异常打印错误信息
        try:
            shutil.move(source_file_path, target_file_path)
            print(f"移动完成：{file_name}")
        except Exception as e:
            print(f"移动文件{file_name}失败，原因：{str(e)}")

额外注意事项 #

• Windows系统下如果操作C盘系统保护目录（如C:\Windows、C:\Program Files），需要右键选择「以管理员身份运行」启动Python脚本，否则会触发权限拒绝错误。
• 代码中路径前的r标记不要删除，避免Windows路径中的反斜杠被Python识别为转义字符导致路径非法。
• 如果需要递归遍历源目录下所有子文件夹内的jpg文件，可将os.listdir遍历逻辑替换为os.walk实现。

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