如何在Python 3.10中快速实现文件的批量MD5重命名？-Python教程-PHP中文网

不能直接对文件路径调用md5()，因为hashlib.md5()只接受bytes输入，传入路径字符串实际是对路径名哈希；正确做法是rb模式分块读取文件内容并update计算。

如何在python 3.10中快速实现文件的批量md5重命名？

直接用 hashlib.md5() 计算文件内容哈希，再重命名即可——但关键不是“能做”，而是避免踩坑：重复哈希、中文路径崩溃、大文件卡死、同名哈希冲突。

为什么不能直接对文件路径调用 `md5()`？

因为 hashlib.md5() 接收的是字节流，不是字符串路径。传入 os.path.basename() 或路径字符串只会哈希路径名本身，不是文件内容。

常见错误现象：md5("report.pdf") 得到的是字符串 "report.pdf" 的哈希，所有同名文件都会重命名成同一个值，完全失效。

正确做法是打开文件、按块读取（防内存爆炸）：

def get_file_md5(filepath):
    h = hashlib.md5()
    with open(filepath, "rb") as f:
        while chunk := f.read(8192):  # 每次读 8KB
            h.update(chunk)
    return h.hexdigest()

如何安全地批量重命名且不覆盖已有文件？

同一目录下多个文件可能算出相同 MD5（极小概率但存在），或已有 abc123...456.jpg 这类名字。硬覆盖会丢数据。

实操建议：

先用 os.path.exists() 检查目标名是否已存在
若存在，在哈希后加序号后缀，如 abc123...456_1.jpg
重命名前用 os.replace()（原子操作，比 os.rename() 在 Windows 更稳）
跳过当前已是纯 MD5 格式的名字（正则匹配 ^[a-f0-9]{32}\.\w+$），避免重复处理

Windows 下中文路径报 `UnicodeEncodeError` 怎么办？

Python 3.10 默认使用系统编码读取命令行参数和路径，Windows 控制台常为 GBK，而 Python 内部用 UTF-8，sys.argv 或 glob.glob() 可能解码失败。

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

根本解决方式不是改 locale，而是绕过字符串解析：

用 pathlib.Path.cwd().iterdir() 替代 os.listdir()，它原生支持 Unicode
所有路径操作统一走 pathlib.Path 对象，不转 str
如果必须从命令行接收路径，用 sys.argv[1].encode('utf-8').decode('utf-8') 强制归一化（仅当确定终端支持 UTF-8 时）

典型崩溃点：os.rename("测试.txt", "a1b2c3...txt") 在 cmd 中直接抛错；换成 Path("测试.txt").rename(Path("a1b2c3...txt")) 就稳。