windows 上跨磁盘移动文件失败的根本原因是 movefileex api 不支持跨卷原子重命名，shutil.move() 的 fallback 机制在 winerror 17 场景下未必触发，path.replace() 则完全不回退，需手动预判跨盘、处理只读属性、校验拷贝完整性并安全删除源文件。
Windows 上 os.rename()、Path.replace() 或 shutil.move() 跨磁盘移动文件时抛出 OSError: [WinError 17] 系统无法将文件移到不同的磁盘驱动器，根本原因不是权限或路径错，而是 Windows 的 MoveFileEx API 本身不支持跨卷原子重命名 —— 它只在同个 NTFS 卷内做 inode 级硬链接复用，跨盘必须拷贝+删除。
为什么 shutil.move() 在 Windows 上也会失败
shutil.move() 底层先调 os.rename()，失败后才 fallback 到 shutil.copy2() + os.unlink()。但这个 fallback 有前提：异常必须是 OSError 且错误码为 errno.EXDEV（Linux/macOS）或 17（Windows）。而 Windows 的 shutil.move() 实现里，对 [WinError 17] 的处理并不总是触发 fallback —— 尤其在 pip、某些旧版 Python 或自定义临时目录场景下，它会直接抛出原始异常。
- pip 卸载时用
shutil.move()把cv2.pyd从E:\Python\...移到C:\Users\...\Temp\...，就卡在第一步os.rename()失败，后续逻辑没执行 -
Path.replace()更彻底：它不尝试 fallback，直接依赖MoveFileEx，跨盘必炸 - 即使你手动调
shutil.move()，若目标路径存在只读文件，copy2()可能因权限失败，而unlink()还没执行，导致源文件被删、目标未写全
手写安全移动函数要检查什么
不能只捕获 OSError，必须显式判断错误码是否为 17（Windows）或 errno.EXDEV（跨平台兼容），并确保 copy2() 成功后再删源文件。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 先用
os.stat(src).st_dev != os.stat(dst_dir).st_dev预判是否跨盘（dst_dir是目标父目录），避免无谓的 rename 尝试 - 目标文件存在时，必须先
os.chmod(dst, stat.S_IWRITE)再os.remove(dst)，否则copy2()会因只读属性失败 -
shutil.copy2()比shutil.copy()必须用：它保留mtime、mode，对配置文件、二进制模块（如.pyd）至关重要 - 删源文件前，确认
copy2()返回值或检查os.path.getsize(dst) == os.path.getsize(src)，防止静默截断
pip 场景下的特殊处理
pip 自身不控制临时目录位置，它默认用系统 Temp（通常是 C:\Users\...\AppData\Local\Temp），而 Python 安装在 D:\ 或 E:\ 时，卸载/安装必然跨盘。这时不能指望 pip 修复，得从环境层面干预：
- 用
pip install --target=D:\myproject\libs package_name强制所有文件落在同一盘符下 - 设
PIP_CACHE_DIR=D:\python\pip_cache环境变量，让缓存和安装路径共盘 - 创建虚拟环境时指定路径在 Python 安装盘：
python -m venv D:\myvenv，再激活安装，彻底隔离路径冲突 - 遇到
pip uninstall卡住，先关掉所有 IDE 和 Python 进程，手动删掉报错中提到的Temp\pip-uninstall-xxx目录，再重试
真正麻烦的从来不是“怎么动”，而是“动完是不是原样”——跨盘操作本质是两次 I/O，中间任何一步失败（磁盘满、进程锁文件、权限突变），都会留下脏状态。所以生产代码里，凡是涉及 .replace() 或 shutil.move() 的地方，都该默认走 fallback 路径，而不是赌它在同盘。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
