使用 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]，提示“无法创建已存在的文件”。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 务必加判断：
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() 得来），直接拼接会破坏层级。
- 始终用
os.path.join(dir_path, filename)构造完整路径 - 或者升级用
pathlib.Path(dir_path) / filename，可读性更强，且自动处理分隔符 - 调试时用
print(repr(old_path))查看实际字符串，比print(old_path)更可靠（能暴露不可见字符）
print() 把将要执行的重命名对列出来，确认无误再放开 os.rename()。空格看似小问题，但批量操作一旦出错，恢复成本远高于多花十秒验证。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
