Python脚本无法在Docker挂载卷间移动文件，但mv命令可成功执行

我来帮你梳理这个问题的核心原因和对应的解决办法：

为什么会出现这个差异？ #

Python的pathlib.Path.rename()/os.rename()的限制 #

你遇到的OSError: [Errno 18] Invalid cross-device link错误，本质是因为Python的rename方法底层调用了系统的rename()系统调用，这个系统调用只支持在同一个文件系统（设备）内做原子重命名操作。而你的/home/ubuntu/downloads和/home/ubuntu/data是两个独立的Docker挂载卷（对应宿主机上的不同目录，属于不同的设备节点），跨设备的重命名操作会直接触发这个错误。

mv命令的智能处理 #

bash中的mv命令则做了更友好的封装：它会先检测源文件和目标路径是否属于同一设备，如果是跨设备，就自动切换为先复制文件到目标位置，再删除原文件的逻辑，所以不会报错，看起来像是“直接移动”成功了。

如何用Python实现类似mv的跨设备移动？ #

你可以使用shutil.move()来替代pathlib.rename()，它会自动处理跨设备的情况：

import shutil
from pathlib import Path

src = Path('/home/ubuntu/downloads/SoftwareEngineer.pdf')
dst = Path('/home/ubuntu/data/') / src.name  # 注意要指定目标文件名，不能只写目录
shutil.move(src, dst)

如果你需要更精细的控制，也可以手动实现复制+删除的逻辑：

from pathlib import Path

src = Path('/home/ubuntu/downloads/SoftwareEngineer.pdf')
dst = Path('/home/ubuntu/data/') / src.name

# 复制文件内容
with src.open('rb') as fsrc, dst.open('wb') as fdst:
    fdst.write(fsrc.read())
# 删除原文件
src.unlink()

补充说明 #

需要注意的是，shutil.move()在跨设备时的操作是非原子的：如果复制过程中出现异常，原文件不会被删除；而同一设备内的os.rename()是原子操作，这是两者在行为上的细微区别，你可以根据自己的场景选择合适的方式。

备注：内容来源于stack exchange，提问作者proofit404