使用Python搭配os.walk()批量将多级目录名称空格换为下划线时脚本失效排查
脚本失效的核心问题定位
以下问题共同导致脚本从启动阶段就中断,完全没有执行到实际重命名逻辑,因此没有产生任何文件改动:
- 错误的强行目录切换逻辑:脚本在遍历每个目录的循环内直接执行
os.chdir("TIFF"),既没有判断当前路径下是否存在TIFF子文件夹,也没有基于实际路径做目录跳转,脚本第一次走到这行代码时就会因为找不到目标目录抛出FileNotFoundError直接退出,后续所有重命名逻辑完全没有执行机会。 - 循环嵌套逻辑错位:文件重命名的循环被错误嵌入在文件夹遍历的内层循环中,即便不触发目录报错,文件重命名操作也会被重复执行N次(N为当前路径下的子文件夹数量),存在极大的冗余逻辑,且无法准确匹配对应层级的文件。
- 遍历顺序设计缺陷:
os.walk默认采用自顶向下的遍历逻辑,如果在遍历过程中修改当前层级的文件夹名称,os.walk内部维护的遍历路径还是旧的目录名,会直接导致深层子目录的遍历路径失效,出现大面积漏改的问题。 - 缺少重名校验逻辑:脚本在执行
os.rename时没有提前判断替换后的新名称是否已经存在对应文件/文件夹,一旦出现重名就会抛出异常中断脚本执行,无法完成全量遍历。
修正后可正常运行的参考实现
脚本采用自底向上的遍历顺序,先处理深层的文件和文件夹,再向上处理上层目录,从根源上避免路径失效问题,同时增加重名判断保障执行稳定性:
#!/usr/local/bin/python3 import os def replace(parent_path): # 关闭自顶向下遍历,优先处理最深层的文件/文件夹 for current_path, sub_folders, sub_files in os.walk(parent_path, topdown=False): # 先处理当前路径下的所有文件 for old_name in sub_files: if ' ' not in old_name: continue old_full_path = os.path.join(current_path, old_name) new_name = old_name.replace(' ', '_') new_full_path = os.path.join(current_path, new_name) # 跳过已存在的重名文件,避免报错中断 if not os.path.exists(new_full_path): os.rename(old_full_path, new_full_path) # 再处理当前路径下的所有子文件夹 for old_folder_name in sub_folders: if ' ' not in old_folder_name: continue old_folder_full_path = os.path.join(current_path, old_folder_name) new_folder_name = old_folder_name.replace(' ', '_') new_folder_full_path = os.path.join(current_path, new_folder_name) if not os.path.exists(new_folder_full_path): os.rename(old_folder_full_path, new_folder_full_path) if __name__ == "__main__": # 调用时把实际的父目录路径传入即可 replace("/你的/实际/parent folder的路径")
执行注意:运行前可以先把
os.rename临时替换为打印新旧路径的语句,先预览要改动的内容,确认无误后再执行实际重命名操作。
内容的提问来源于stack exchange,提问作者HBMCS
相关产品推荐
相关产品推荐

