shutil.move()跨分区时自动降级为复制+删除，因os.rename()仅同文件系统支持原子重命名；此举导致无进度、无校验、中断易丢数据，应改用流式复制+哈希校验+安全清理。
为什么 shutil.move() 在跨分区时会变成复制+删除
Python 的 shutil.move() 看似“移动”，但底层依赖 os.rename()。而 os.rename() 仅在**同一文件系统内**才真正原子重命名；一旦源路径和目标路径位于不同磁盘（比如 /home 在 sda1，/mnt/data 在 sdb1），它会自动 fallback 到“先复制再删除源文件”的逻辑。这意味着：你没显式控制复制过程，却要承担完整副本的磁盘空间、I/O 时间和中断风险。
- 若复制中途断电或 Ctrl+C，可能留下不完整的目标文件 + 已删除的源文件 → 数据丢失
- 没有进度反馈，大文件（如 50GB 视频）卡住时无法判断是慢还是卡死
- 默认不校验完整性，复制出错（如坏扇区）后目标文件损坏却无感知
用 shutil.copyfileobj() 手动流式复制 + 校验 + 清理
安全跨分区移动的本质是：可控复制 + 可靠校验 + 原子清理。不要依赖 shutil.move() 的自动 fallback，自己分步做：
- 用
shutil.copyfileobj()分块读写（避免内存爆满），同时计算hashlib.sha256()流式哈希 - 复制完成后，比对源文件与目标文件的哈希值；不一致则
os.remove()目标并报错 - 仅当校验通过，才调用
os.remove()删除源文件 - 所有关键步骤用
try/except包裹，确保异常时目标文件被清理（防止残留垃圾）
示例核心逻辑：
import shutil
import hashlib
import os
<p>def safe_move_across_fs(src, dst):</p><h1>1. 复制并计算哈希</h1><pre class="brush:php;toolbar:false;">h = hashlib.sha256()
with open(src, "rb") as fsrc, open(dst, "wb") as fdst:
while chunk := fsrc.read(1024*1024): # 1MB chunks
fdst.write(chunk)
h.update(chunk)
src_hash = h.hexdigest()
# 2. 校验目标文件
with open(dst, "rb") as f:
dst_hash = hashlib.file_digest(f, "sha256").hexdigest()
if src_hash != dst_hash:
os.remove(dst)
raise RuntimeError(f"Hash mismatch: {src} vs {dst}")
# 3. 安全删除源
os.remove(src)
A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.
下载
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
注意 shutil.copy2() 和 copyfile() 的权限/元数据陷阱
如果需要保留修改时间、权限等元数据，不能只用 shutil.copyfile()（它只拷内容）。但直接上 shutil.copy2() 有坑：
-
shutil.copy2()在跨分区时仍会 fallback 复制，但它**不提供进度或校验钩子**，你无法插入哈希计算 - 某些文件系统（如 exFAT、FAT32）不支持 Unix 权限或纳秒级 mtime，
copy2()可能静默失败或丢弃属性 - Windows 上 NTFS 符号链接、ACL 等高级属性，
copy2()默认不处理
建议：先用 shutil.copyfile() 或流式复制保证内容正确，再单独用 shutil.copystat() 尝试同步基础属性（并捕获 OSError 忽略不支持项），不要强求“完全一致”。
大文件场景下必须检查磁盘空间和硬链接行为
即使做了校验，忽略磁盘空间和硬链接也会翻车：
- 复制前用
shutil.disk_usage()检查目标分区剩余空间是否 ≥ 源文件大小；否则直接报错，别等写到一半No space left on device - 如果源文件是硬链接（
os.stat().st_nlink > 1），直接os.remove()不会删数据，但用户可能误以为“已移走”。应提前检测并警告：“源文件有多个硬链接，删除后其他路径仍可访问” - 不要用
os.link()或os.symlink()替代移动——它们不跨文件系统，且不是用户想要的“移动”语义
跨分区移动从来就不是“原子操作”，所谓安全，就是把每一步的失败可能性都列出来，并为每种失败设计回退动作。最常被跳过的其实是空间检查和硬链接提示——等复制完发现目标盘满了，或者删了源却发现还有个同 inode 的路径在别处，就只能手动救火了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
