使用Python os.rename批量重命名后仅余最后一个文件的原因排查

兄弟，我一眼就瞅出你代码里的致命bug了，这直接导致你359个文件被覆盖消失，只剩最后一个！

核心问题：错用了循环残留的val变量 #

你看代码里重命名的那一行：

os.rename(path+name, path+val)

这里的val是你之前遍历new_list.txt时，最后一次循环赋值的变量——它根本不是当前要重命名的文件对应的新文件名！

举个实际场景：假设你的new_list.txt最后一行的旧文件是file360.png，对应新名是last_file.png，那不管前面的文件匹配到什么新名字，所有文件都会被强行改成last_file.png。在同一个目录下，后面重命名的文件会直接覆盖掉之前同名的文件，所以前面359个文件全被最后那一个给覆盖没了。

消失的文件去哪了？ #

它们并没有真的“消失”，而是被后续重命名的同名文件直接覆盖删除了。macOS系统里用os.rename重命名时，如果目标文件名已经存在，系统会静默替换旧文件，连个提示都没有——所以前面的文件全被后面的给顶掉了，最终只剩最后完成重命名的那个。

你忽略了什么？ #

• 变量作用域的坑：val是在遍历文件名映射列表的循环里定义的，循环结束后它只保留最后一次循环的值，你错误地在后续的文件重命名循环里直接用了这个变量，而不是从file_dict里取当前旧文件对应的新名。
• 另外，直接用字符串拼接路径（path+name）不如用os.path.join安全，不过这不是核心问题，但也是个值得注意的小细节。

修复后的关键代码 #

把重命名的那几行改成这样就行：

# 先从字典里拿到当前文件对应的新名字
new_name = file_dict.get(name.strip())
print('***** renaming: ', os.path.join(path, name), ' to: ', os.path.join(path, new_name))
# 用os.path.join拼接路径更稳妥，避免路径分隔符问题
os.rename(os.path.join(path, name), os.path.join(path, new_name))

额外小提醒 #

• 可以在重命名前加个判断：如果目标文件已经存在，就跳过或者提示，避免意外覆盖（虽然你说所有目标文件都在字典里，但加个判断更保险）
• 遍历文件时用os.scandir比os.listdir更高效，还能直接获取文件属性，不用再额外调用os.path.isfile

内容的提问来源于stack exchange，提问作者99Valk