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

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

在使用 pythonos.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() 前检测或清洗目录名,提升代码健壮性和用户体验。

六、思考题 🤔

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

欢迎在评论区讨论!

相关推荐
Joy-鬼魅6 小时前
Qt 项目文件(.pro)中添加 UI 文件相关命令
开发语言·qt·ui
毕设源码-赖学姐6 小时前
【开题答辩全过程】以 基于Spring Boot的网上家庭烹饪学习系统的设计与实现为例,包含答辩的问题和答案
spring boot·后端·学习
Kingairy6 小时前
Pytest 插件:pytest_runtest_protocol
python·pytest
钢铁男儿6 小时前
【C#实战】使用ListBox控件与生成器模式构建灵活多变的金融资产管理系统
开发语言·c#
sheji34166 小时前
【开题答辩全过程】以 基于python爬虫对微博数据可视化及实现为例,包含答辩的问题和答案
爬虫·python·信息可视化
Moonbit6 小时前
MoonBit Pearls Vol.08: MoonBit 与 Python集成指南
后端·python·程序员
张三xy7 小时前
Java网络编程基础 Socket通信入门指南
java·开发语言·网络协议
扯淡的闲人7 小时前
Beego: Go Web Framework 详细指南
开发语言·golang·beego
CodeDevMaster7 小时前
从零开始:用uv构建并发布一个Python CLI应用,集成CI/CD自动化发布与Docker容器化部署
python·ci/cd·docker