正确做法是自底向上处理:先收集所有目标目录路径并按深度降序排序,再逐个重命名;使用os.path.join或pathlib.Path拼接路径;替换时优先str.replace(),复杂模式用re.sub()并锚定;重命名前检查存在性和权限,支持dry_run预览。

用 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(),但要注意转义和贪婪匹配。
常见翻车点:
立即学习“Python免费学习笔记(深入)”;
- 误用
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 参数。


















