修改嵌套目录名称,最麻烦的地方在于:子目录一旦改名,父目录的路径就失效了,后续遍历会报错或直接跳过。所以,正确的做法是自底向上处理——先收集所有目标目录路径,按深度降序排序,再逐个重命名。

用 os.walk() 遍历多级目录并重命名文件夹
直接硬改嵌套目录名,可别指望用 os.rename() 套个循环就完事。子目录一改名,父目录的路径就跟着变了,后续遍历要么报 FileNotFoundError,要么直接跳过。正确做法是**自底向上处理**:先把所有目标目录路径收集起来,按路径深度从大到小排序,再逐个重命名。
这里有两个关键点:路径深度怎么算,以及排序逻辑怎么写。
- 深度计算:用
path.count(os.sep)或者len(path.split(os.sep))都行,注意 Windows 路径分隔符的兼容性问题。 - 排序逻辑:对路径列表按深度降序排列,
sorted(paths, key=lambda p: -p.count(os.sep))就能搞定。 - 避坑提醒:千万不要在
os.walk()遍历过程中直接改名。先list()把结果存下来,再慢慢处理。
匹配与替换逻辑:用字符串操作还是正则?
如果只是固定前缀或后缀替换,比如把所有 "old_" 换成 "new_",用 str.replace() 最快也最安全。但要是遇到模糊匹配,比如数字编号、日期格式这类,那必须上 re.sub(),不过得小心转义和贪婪匹配的问题。
几个常见的翻车现场:
- 误用
str.replace(old, new)导致部分路径被多次替换。比如想把"abc"改成"ab",结果"abcc"也被改了。 - 正则没加
^或$锚定,把路径中间的字符也替换了。 - Windows 下大小写不敏感,但
os.rename()实际区分大小写,结果就是“重命名失败但没报错”,这种问题排查起来最头疼。
推荐写法:new_name = re.sub(r'^old_(\d+)$', r'new_', folder_name),只作用于文件夹名本身,不碰路径,干净利落。
安全重命名:检查冲突、跳过权限问题
批量改名,最怕的就是覆盖或中途中断。必须显式检查目标路径是否存在,以及当前用户有没有写权限。
- 用
os.path.exists(new_path)判断是否已存在同名目录。存在就跳过,或者加个后缀,比如_v2。 - 用
os.access(parent_dir, os.W_OK)检查父目录是否可写,否则os.rename()会直接抛PermissionError。 - 改名失败时,一定要记录日志,把路径和错误类型都记下来。千万别用
try/except pass把异常吞掉,不然出了问题根本不知道错在哪。 - 强烈建议加个预览模式开关:设置
dry_run=True,只打印将要执行的操作,确认无误再真正运行。
跨平台路径拼接必须用 os.path.join() 或 pathlib.Path
硬拼字符串,比如 parent + "/" + name,在 Windows 下必然出错。哪怕你本地测试没问题,部署到服务器就崩了。
两种推荐方式:
- 传统写法:
new_path = os.path.join(os.path.dirname(old_path), new_name) - 现代写法,更清晰:
old_p = pathlib.Path(old_path); new_p = old_p.parent / new_name
注意:pathlib.Path 的 / 运算符会自动处理分隔符,而且 .rename() 方法比 os.rename() 更直观——old_p.rename(new_p) 一步到位。
真正容易被忽略的是符号链接和挂载点。os.walk() 默认不进入 symlink,但如果你手动构造路径并重命名,可能意外影响到其他位置。确认业务场景是否涉及软链,必要时加 follow_symlinks=False 参数。