Python怎么移动文件_shutil.move()剪切文件与目录迁移

文件迁移是日常开发中最常见的操作之一。很多开发者第一次用 shutil.move() 时，都会撞上一个坑——它居然会静默覆盖同名文件，连个提示都没有。这里说说几个容易忽略的细节，帮你避坑。

shutil.move() 会静默覆盖同名文件

这是最常被吐槽的一个特性。shutil.move() 遇到目标路径已存在同名文件或空目录时，会直接覆盖或重命名（取决于目标类型），不会抛出异常，也不会弹出确认框。举个例子，你把 report.txt 移动到已有 report.txt 的目录下，原文件就被无声无息地替换了。

实际操作中，建议移动前先用 os.path.exists() 检查目标路径是否存在，再用 os.path.isfile() 或 os.path.isdir() 判断目标类型。如果目标已经是文件，可以改用 os.replace() 做原子替换，或者自己手动备份旧文件，不要依赖 shutil.move() 的默认行为。

另外需要注意，跨文件系统移动时，shutil.move() 本质上执行的是"复制+删除"操作，失败时可能留下残缺副本，所以务必加上异常捕获和清理逻辑。

移动目录时，目标不能是子目录

假设源路径是 /a/b，你把目标写成 /a/b/c，运行时会直接报错：OSError: Same file or directory。原因很简单——系统检测到目标路径位于源路径的目录树内，拒绝了这种自包含操作。

建议用 os.path.commonpath([src, dst]) 提前判断两个路径是否构成父子关系（注意处理符号链接的情况）。目标路径必须是一个完全独立的目录，哪怕只是换成 /tmp/b，也比 /a/b/c 安全得多。

Windows 下还需要注意大小写不敏感的问题。C:\A\B 和 c:\a\b 可能被误判为同一路径，稳妥的做法是统一转成小写再做比对。

Windows 上对正在使用的文件会失败

如果目标文件正被其他进程占用——比如 Excel 正在编辑 data.xlsx——shutil.move() 会在 Windows 下抛出 PermissionError: [WinError 32] The process cannot access the file...。Linux 和 macOS 的行为则不同：只要权限充足，可以移动正在写入的文件（因为 inode 不变），但 Windows 的句柄锁定机制会让操作直接失败。

针对这个问题，在 Windows 环境下建议用 try/except PermissionError 包裹移动操作，并添加短延时重试，最多尝试 2 到 3 次就够了。日志轮转、数据库导出等场景中不要假设文件"刚写完就可移"，实际上可能还在 flush 缓冲区。如果实在需要，可以改用 shutil.copy2() 加上 os.remove() 分两步完成，但要清楚这会失去原子性。

替代方案：pathlib.Path.replace() 更轻量，但只支持文件

pathlib.Path.replace() 是 Python 3.4+ 引入的原生路径操作，语义清晰，既不跨文件系统，也不会自动创建父目录，适合单文件迁移。不过它不支持移动整个目录，也不能像 shutil.move() 那样自动处理跨磁盘场景。

如果只是迁移单个文件，优先用 Path('old.txt').replace(Path('new.txt'))，它比 shutil.move() 少一层封装，报错信息也更明确。需要注意，目标父目录不存在时 .replace() 会直接报 FileNotFoundError，所以必须提前调用 Path('new.txt').parent.mkdir(parents=True, exist_ok=True)。另外，不要用它移动目录——会抛出 IsADirectoryError，这种情况只能退回 shutil.move() 或者手写递归逻辑。