Windows路径超长导致FileNotFoundError或WinError 206,需先启用系统长路径支持(组策略或注册表设LongPathsEnabled=1),再在Python中用r"?"+os.path.abspath(path)构造绝对长路径,pathlib需手动添加前缀。

Windows下Python文件操作报错FileNotFoundError或OSError: [WinError 206]?先确认是否路径超长
Windows默认限制路径总长度为260字符(MAX_PATH),超过就会触发OSError: [WinError 206] The filename or extension is too long,哪怕文件真实存在。这不是Python的bug,是系统级限制。Python 3.6+已支持长路径,但需满足两个前提:系统启用长路径支持 + Python显式启用兼容模式。
启用Windows系统级长路径支持(必须第一步)
不改系统设置,Python再怎么配置都无效。需在组策略或注册表中开启:Computer Configuration > Administrative Templates > System > Filesystem > Enable Win32 long paths。若用家庭版无组策略,直接改注册表:HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystemLongPathsEnabled设为1(DWORD)。重启后生效——很多用户跳过这步,后续所有尝试都会失败。
Python中启用长路径前缀\?的正确方式
Windows长路径前缀\?不是万能补丁,它绕过API路径解析,但也带来副作用:禁用相对路径、通配符和..解析,且只对绝对路径有效。Python不会自动加这个前缀,必须手动拼接:
# ✅ 正确:转为绝对路径后再加前缀
import os
path = r"C:erydeepolderwithmanysubdirsile.txt"
long_path = r"\?" + os.path.abspath(path)
<h1>❌ 错误:相对路径加前缀会直接失败</h1><p>bad_path = r"?..dataile.txt" # OSError: invalid path</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill6081" title="python-code-analyz"><img
src="https://img.php.cn/upload/skill/000/000/081/179077148379011.jpg" alt="python-code-analyz" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill6081" title="python-code-analyz">python-code-analyz</a>
<p>专业Python代码分析与优化,支持语法检查、安全扫描、性能评估、复杂度分析及重构后优化代码生成。</p>
</div>
<a href="/xiazai/skill6081" title="python-code-analyz" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记(深入)</a>”;</p><h1>❌ 错误:没转绝对路径,前缀无效</h1><p>partial_path = r"?dataile.txt" # 仍受260限制
-
os.path.abspath()必须调用,确保路径是绝对的 -
\?后不能有UNC前缀(如\servershare要写成\?UNCservershare) - 所有标准库函数(
open()、os.listdir()、shutil.copy())都支持该前缀,但pathlib.Path在3.11前不自动处理,需手动构造Path(r"\?" + abs_path)
替代方案:用os.path.normpath()精简路径再操作
不是所有超长路径都必须用\?。有时路径含大量.或..冗余段,导致逻辑长度超标但实际很短。先归一化再操作更安全:
import os raw_path = r"C:..cde....gile.txt" clean_path = os.path.normpath(raw_path) # → "C:\a\b\c\g\file.txt" # 再检查长度,可能根本不需要长路径前缀
-
os.path.normpath()不访问文件系统,纯字符串处理,开销极小 - 适用于构建路径时未清理中间变量的场景(比如拼接多个
os.path.join()结果) - 注意:它不解决真实深度超限问题(如50级嵌套目录),只解决“假性超长”
真正难处理的是那些既无法精简、又跨域权限/符号链接的超长路径——这时候\?是唯一选择,但务必记住:系统设置没开,一切白搭;路径没转绝对,前缀失效;用pathlib时得自己动手加前缀。

















