pytorch在windows下报winerror 123,主因是路径含中文、空格或反斜杠被误解析为转义字符;推荐用raw字符串(如r"c:model.pth")、正斜杠("c:/model.pth")或pathlib.path自动处理分隔符。

PyTorch报错 OSError: [WinError 123] 文件名、目录名或卷标语法不正确 怎么办
这是 Windows 下 PyTorch 加载模型或数据集时最典型的路径编码问题:路径里含中文、空格或反斜杠 被 Python 当作转义字符处理,导致 torch.load() 或 torchvision.datasets.ImageFolder 读取失败。根本原因不是 PyTorch 本身,而是 Windows 路径字符串在 Python 中的解析逻辑。
用 raw 字符串(r"...")是最直接、最低侵入性的修复方式——它让 Python 完全忽略反斜杠的转义含义,原样传递给系统 API。
- 错误写法:
"C:modelsest.pth"→和被解释为退格符和制表符,路径非法 - 正确写法:
r"C:modelsest.pth"或"C:/models/best.pth"(正斜杠在 Windows 上完全兼容) - 注意:raw 字符串末尾不能是单个反斜杠,
r"C:"是语法错误;要用r"C:\"或r"C:/
torch.load() 和 torch.save() 的路径必须用 raw 字符串吗
不是“必须”,但强烈建议统一使用。因为 torch.load() 底层调用的是 Python 的 open(),而 Windows 对路径中转义字符极其敏感。哪怕路径全是英文,只要含
、 、
等组合,就可能意外触发错误。
实操建议:
- 加载模型:
model = torch.load(r"D:projectscvmodel_v2.pth") - 保存模型:
torch.save(model.state_dict(), r"E:ackupckpt_epoch100.pth") - 如果路径来自变量(比如用户输入或配置文件),不要拼接 raw 字符串,改用
os.path.join()或pathlib.Path自动处理分隔符
用 pathlib.Path 替代 raw 字符串更可靠吗
是的,尤其当路径需要拼接、判断存在性或跨平台部署时。pathlib 会自动适配系统分隔符,且对象本身支持链式操作,比 raw 字符串更健壮。
对比示例:
from pathlib import Path
<h1>raw 字符串(简单场景够用)</h1><p>ckpt_path = r"C:dataweightsinal.pt"
model = torch.load(ckpt_path)</p><h1>pathlib(推荐用于复杂路径逻辑)</h1><p>ckpt_path = Path("C:/data") / "weights" / "final.pt"
if ckpt_path.exists():
model = torch.load(ckpt_path)</p>
注意:Path 对象传给 torch.load() 没问题(PyTorch 内部会调用 str()),但某些旧版本 PyTorch(如 1.7 以下)可能不支持,此时需显式转成字符串:str(ckpt_path)。
为什么有时不用 raw 字符串也没报错
因为你的路径恰好没触发转义:比如 "C: empmodel.pth" 看似正常,但 实际被解析为制表符,只是文件系统碰巧返回了“找不到文件”而非语法错误,掩盖了问题。一旦路径变成 "C:
ew est.pth"(
是换行符),立刻崩。
真正安全的做法是:所有硬编码的 Windows 路径,要么加 r 前缀,要么统一用正斜杠,要么交给 pathlib 管理。别依赖“这次没出错”来判断是否正确。
最容易被忽略的一点:IDE(如 PyCharm、VS Code)的调试控制台或终端里复制的路径,常带隐藏的 Unicode 字符或混合斜杠,粘贴后看着一样,实际已损坏——务必手动重敲或用 repr() 检查字符串真实内容。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











