os.rename()在Windows触发WinError3找不到路径，Linux正常如何解决？

问题概述 #

以下代码用于半自动重命名媒体文件，在Debian/Ubuntu系统可正常运行，但在Windows系统执行时触发路径找不到的错误，改用os.renames也无法解决。

原代码 #

def findingmedia(directory):
    media=[]
    for path,subdir, files in os.walk(directory):
        for file in files:
            #Appends the path and names of video files into media list.
            if file.lower().endswith(video_formats):
                media.append((path,file))
    return media


#Rename according to inputs provided by the user
def rename(media):
    count=0
    for element in media:
        #Take input for the new name from user
        print(f'The name of this file is {element[1]}')
        nname=str(input("Enter the new name for this file \n"))
        splitname=element[1].split('.')
        format=splitname[-1]
        nname=nname+'.'+format
        try:
            file=os.path.join(element[0], element[1])
            newname= os.path.join(element[0], nname)
            #Rename
            os.rename(file, newname)
            print(f'File with name {element[1]} renamed to {nname} successfully')
            count+=1
        except OSError as error:
            print(f"Could not rename file {element[1]} \n Error = {error}")
    return count

Windows下错误信息 #

Could not rename file mediatest1.mkvError = [WinError 3] The system cannot find the path specified: 'C:\Users\mg15d\Downloads\The mediatest1 1080p AMZN WEB-DL DDP5 1 H 264-NTb[TGx]\mediatest1.1080p.AMZN.WEB-DL.DDP5.1.H.264-NTb.mkv' -> 'C:\Users\mg15d\Downloads\mediatest1 1080p AMZN WEB-DL DDP5 1 H 264-NTb[TGx]\renamedwuhu.mkv'

改用os.renames后的错误：

Error = [WinError 3] The system cannot find the path specified: 'C:\\Users\\mg15d\\Downloads\\The mediatest1 1080p AMZN WEB-DL DDP5 1 H 264-NTb[TGx]\\mediatest1.1080p.AMZN.WEB-DL.DDP5.1.H.264-NTb.mkv' -> 'C:\\Users\\mg15d\\Downloads\\mediatest1 1080p AMZN WEB-DL DDP5 1 H 264-NTb[TGx]\\renamedwuhu.mkv'

问题原因 #

1. Windows路径特殊字符解析问题：文件夹名称中的[TGx]属于Windows系统的通配符字符（方括号用于匹配范围内的字符），Python的os模块调用Windows API时，会将这类字符当作通配符处理，而非路径的一部分，导致系统无法定位到实际文件。
2. 路径构造异常：错误信息显示新路径的文件夹名称丢失了开头的The ，说明element[0]在Windows下存在路径解析异常，导致构造的新路径指向错误的文件夹。

解决方案 #

方案1：使用pathlib模块（推荐） #

pathlib是Python 3.4+内置的面向对象路径处理模块，能自动处理跨平台路径差异，且对特殊字符路径的兼容性更好。

修改后的代码：

from pathlib import Path

def findingmedia(directory):
    media = []
    # 使用Path.glob递归遍历所有视频文件，自动处理路径特殊字符
    for media_path in Path(directory).rglob('*'):
        if media_path.is_file() and media_path.suffix.lower() in video_formats:
            media.append((media_path.parent, media_path.name))
    return media

def rename(media):
    count = 0
    for element in media:
        parent_path, file_name = element
        print(f'The name of this file is {file_name}')
        nname = input("Enter the new name for this file \n").strip()
        # 直接获取文件后缀，避免手动拆分出错
        suffix = Path(file_name).suffix
        nname_with_suffix = f"{nname}{suffix}"
        try:
            old_path = parent_path / file_name
            new_path = parent_path / nname_with_suffix
            # 使用Path.rename方法，跨平台兼容性更强
            old_path.rename(new_path)
            print(f'File with name {file_name} renamed to {nname_with_suffix} successfully')
            count += 1
        except OSError as error:
            print(f"Could not rename file {file_name} \n Error = {error}")
    return count

方案2：使用win32api直接调用Windows API（仅Windows） #

如果需要兼容旧Python版本，可使用pywin32库的MoveFile函数，绕过通配符解析：

1. 先安装依赖：pip install pywin32
2. 修改代码中的重命名逻辑：

import win32api

# 在rename函数的try块中替换os.rename为以下代码：
win32api.MoveFile(file, newname)

额外注意事项 #

• 确保video_formats是包含后缀的集合，比如video_formats = {'.mkv', '.mp4', '.avi'}，避免匹配错误。
• 输入新文件名时，避免包含Windows禁止的字符：< > : " / \ | ? *。

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