Python os.makedirs 报错:OSError: [WinError 123] 文件名、目录名或卷标语法不正确 的解决方案

Python os.makedirs 报错:OSError: [WinError 123] 文件名、目录名或卷标语法不正确 的解决方案

在使用 python 的 os.makedirs() 创建文件夹时,你可能会遇到如下报错:

python 复制代码
File "D:\Python310\lib\os.py", line 225, in makedirs
    mkdir(name, mode)
OSError: [WinError 123] 文件名、目录名或卷标语法不正确。

一、问题原因

这是因为 Windows 系统对文件夹(目录)命名有严格限制 。

如果文件名中包含以下非法字符,就会触发 WinError 123 错误:

复制代码
\   /   :   *   ?   "   <   >   |

当你尝试用这些字符作为文件名时,Windows 会提示:


二、解决思路

核心思路就是 在调用 os.makedirs() 前,先检查文件名是否合法 。

如果包含非法字符,则提示用户重新输入。


三、示例代码

1. 定义检测函数

python 复制代码
# 易懂
def is_supported(dir_name):
    unsupported_char_list = ["\\", "/", ":", "*", "?", "\"", "<", ">", "|"]
    for char in unsupported_char_list:
        if char in dir_name:
            return 0
    return 1
python 复制代码
# 简洁
def is_supported(dir_name: str) -> bool:
    """
    判断目录名是否合法(Windows 下不允许含有特定字符)
    """
    unsupported_chars = ["\\", "/", ":", "*", "?", "\"", "<", ">", "|"]
    return not any(char in dir_name for char in unsupported_chars)

2. 在逻辑代码中使用

python 复制代码
title = "test|dir"   # 示例:非法目录名

if not is_supported(title):
    title = input(
        f'"{title}"不可作为文件名(请注意文件名不能包含下列任何字符 /:*?"<>| ),请输入合法名:'
    )

os.makedirs(title)
print(f"文件夹 {title} 创建成功!")

四、优化点

  • 健壮性 :在实际项目中,可以将 title 清洗为合法文件名,而不仅仅是让用户重新输入。例如自动替换非法字符:
python 复制代码
import re

def sanitize_dir_name(dir_name: str) -> str:
    """
    自动替换非法字符为下划线 _
    """
    return re.sub(r'[\\/:"*?<>|]', "_", dir_name)
  • 跨平台兼容:Linux 和 MacOS 文件名限制少,但建议同样处理,避免迁移时出错。

五、总结

  1. OSError: [WinError 123] 常见于 非法目录名。
  2. Windows 下禁止的字符包括:\ / : * ? " < > |。
  3. 建议在 os.makedirs() 前检测或清洗目录名,提升代码健壮性和用户体验。

六、思考题 🤔

  • 如果目录名来自用户输入,如何设计更优雅的错误提示?
  • 你更倾向于 让用户重新输入 ,还是 程序自动替换非法字符?

欢迎在评论区讨论!

相关推荐
布莱克6058 分钟前
Swift 枚举详解:从基础语法到关联值与模式匹配
开发语言·ios·swift·枚举
__underline__14 分钟前
冷门Python知识点007篇:list[int]不是类,为什么能当基类?
后端·python
Dmz丶18 分钟前
前端转 AI 100 天 Day 49:文档切分——RAG 效果的隐形开关
python
布莱克6051 小时前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
重生之我是萧炎1 小时前
PR安装教程,Adobe Premiere Pro安装教程(含安装包),仅供学习使用
学习·adobe
青少儿编程课堂1 小时前
第十八届蓝桥杯青少组图形化真题 + 全国青少年信息素养大赛 + 电子学会图形化考级:校园泡泡堂大挑战解析
c++·python·算法·bfs·信息学竞赛
蒸蒸yyyyzwd2 小时前
深搜广搜学习笔记
笔记·学习
小七在进步2 小时前
string的实现(3)
开发语言·c++·笔记·visual studio
Starry-sky(jing)2 小时前
Hermes Agent 升级 v0.23.2:先辨更新渠道,再看 CLI 退出残留修复
人工智能·python·ai agent
2601_967979122 小时前
“Python,就是新的 BASIC!”
python·编程语言·历史·basic·比较