Windows下Python报FileNotFoundError但文件存在，大概率是路径总长超260字符触发MAX_PATH限制；需验证路径长度、启用系统长路径支持（注册表+Python≥3.6+关闭兼容模式）、临时改TMP/TEMP或代码中加“?”前缀处理。
Windows 下 Python 报 OSError: [Errno 2] No such file or directory 或 FileNotFoundError，但文件确实存在——大概率不是代码或权限问题，而是路径总长超 260 字符触发了系统级 MAX_PATH 限制。改注册表只是前提，不满足其余条件照样失败。
确认是不是长路径导致的报错
别急着改配置，先验证是否真被长度卡住：
- 在资源管理器地址栏粘贴完整路径，打不开且提示“路径不存在”或“太长”，基本锁定
- PowerShell 中运行
Get-Item "你的完整路径"，若报错含Cannot find path和260或MAX_PATH字样，就是它 -
os.path.exists()或Path().exists()返回False，但把父目录重命名为短名后立刻变True，也是典型表现 - 用
len(os.path.abspath("your_path"))数一下，超过 240 就高度可疑（留出函数调用开销）
启用系统长路径支持（需管理员+重启）
仅改注册表不够，必须同时满足三要素：注册表项生效、Python ≥ 3.6、进程非兼容模式运行。
- 注册表路径是
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystem，LongPathsEnabled值设为1（DWORD，十进制） - 务必检查当前生效的
ControlSet编号：打开HKEY_LOCAL_MACHINESYSTEMSelect，看Current值（如0x00000002），然后去对应ControlSet002路径下设置，不是软链接CurrentControlSet - Python 版本必须 ≥ 3.6（3.6+ 才默认调用长路径 API；conda 环境里可能仍是旧版 Python，需单独确认）
- 右键
python.exe→ 属性 → 兼容性 → 确保“以兼容模式运行”未勾选；IDE（PyCharm/VS Code）也要关闭兼容模式并彻底重启（任务管理器杀掉残留python.exe进程）
临时绕过：改 TMP/TEMP 环境变量（最快见效）
不依赖系统设置，直接缩短 pip 解压时的临时路径前缀，对 volcengine-python-sdk、aws-cli 等深嵌套包立竿见影。
立即学习“Python免费学习笔记（深入）”；
- 在 C 盘根目录新建空文件夹：
C: mp - 当前终端生效（PowerShell）：
$env:TMP="C: mp"; $env:TEMP="C: mp" - 永久生效：系统属性 → 高级 → 环境变量 → 编辑用户变量
TMP和TEMP，值设为C: mp -
pip install会把包解压到这个路径下，只要C: mp+ 包内相对路径总长 ≤ 260，就能避开错误
代码中安全处理长路径（避免漏一处就崩）
即使系统已启用长路径，os.listdir()、shutil.copytree() 等旧接口在低版本 Python 下仍可能失败；手动拼 "\?\" + path 容易出错，且不适用于 UNC 路径。
- 本地绝对路径需加
"\?\\"前缀：Path(r"\?\\" + str(p.resolve()))；UNC 路径必须用"\?\UNC\server\share"，不能只加"\?\" -
os.path.join()拼出的路径若超长，后续传给open()仍会崩，得提前加前缀或确保已 resolve - 动态导入模块时，
importlib.util.spec_from_file_location()不自动绕过MAX_PATH，优先用ctypes调用GetShortPathNameW转短路径 - 中文路径要特别小心：
UTF-8下一个汉字占 3 字节，260 字符 ≈ 86 个汉字，很容易越界
真正麻烦的不是改注册表或加前缀，而是所有路径操作——从 pip install 到 import、从 open() 到 shutil.copytree()——都得统一考虑这个限制。漏掉任意一环，FileNotFoundError 就在那儿等着你。
