如何解决Python项目在Windows环境下路径长度超限导致的异常？-Python教程-PHP中文网

windows下python报filenotfounderror但文件存在，大概率是路径总长超260字符触发max_path限制；需验证路径长度、启用系统长路径支持（注册表+python≥3.6+关闭兼容模式）、临时改tmp/temp或代码中加“?”前缀处理。

如何解决python项目在windows环境下路径长度超限导致的异常？

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、进程非兼容模式运行。

提示词大师-python版

图片提示词生成器？不止如此。马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。输入「新手指南」查看完整功能介绍

下载

注册表路径是 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 等深嵌套包立竿见影。

在 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 个汉字，很容易越界