使用 os.listdir() 时应先用 os.path.isfile() 过滤文件,再按扩展名筛选;重命名前须判断新旧路径是否相同并检查目标是否存在;空格处理推荐 re.sub(r"\s+", "_", name.strip());路径拼接务必用 os.path.join() 或 pathlib.Path。

用 os.listdir() 获取文件列表时,别直接遍历当前目录的全部内容
很多脚本一上来就写 for file in os.listdir("."):,看似简单,但容易误改子目录名、隐藏文件(如 .git)、甚至脚本自身。真实场景中你通常只想处理特定类型(比如 .txt、.py)的普通文件,且不进子目录。
- 先用
os.path.isfile()过滤掉目录 - 用
str.endswith()或pathlib.Path.suffix限定扩展名,避免重命名.DS_Store或__pycache__ - 如果要递归处理子目录,明确用
os.walk(),而不是依赖listdir的扁平结果
调用 os.rename() 前必须检查新旧路径是否相同
空格替换成下划线后,如果原文件名不含空格(比如 report.pdf),new_name 和 old_name 完全一致——此时执行 os.rename(old, new) 在某些系统(尤其是 Windows)会抛出 OSError: [WinError 183],提示“无法创建已存在的文件”。
- 务必加判断:
if old_path != new_path: - 更稳妥的做法是先用
os.path.exists(new_path)检查目标是否已存在,避免覆盖(尤其当多个文件替换后撞名时) - 建议把
os.rename()包在try/except里,捕获PermissionError或FileExistsError并打印具体文件名,方便排查
用 str.replace(" ", "_") 处理空格不够健壮
用户说“空格”,但实际可能遇到连续空格、首尾空格、制表符 \t、全角空格( )、甚至换行符混在文件名里。单纯 " ".replace(" ", "_") 会把 "data 2024.txt" 变成 "data__2024.txt"(双下划线),也不清理开头结尾。
- 推荐用正则:
re.sub(r"\s+", "_", name.strip()),一次性合并所有空白字符并去首尾 - 如果不想引入
re,可用" ".join(name.split())——str.split()默认按任意空白分割并自动去首尾 - 注意:全角空格不属于
\s,若确定存在,需额外替换name.replace(" ", "_")(注意这个是中文全角)
Windows 下路径拼接必须用 os.path.join() 或 pathlib.Path
手写 old_path = "./" + filename 看似省事,但在 Windows 上会生成 .\file name.txt 这类混合斜杠路径,os.rename() 可能失败或行为异常;更严重的是,如果 filename 本身含路径(比如从 os.walk() 得来),直接拼接会破坏层级。
立即学习“Python免费学习笔记(深入)”;
- 始终用
os.path.join(dir_path, filename)构造完整路径 - 或者升级用
pathlib.Path(dir_path) / filename,可读性更强,且自动处理分隔符 - 调试时用
print(repr(old_path))查看实际字符串,比print(old_path)更可靠(能暴露不可见字符)
print() 把将要执行的重命名对列出来,确认无误再放开 os.rename()。空格看似小问题,但批量操作一旦出错,恢复成本远高于多花十秒验证。


















