一、问题概述：[Errno 22] Invalid argument 文件路径非法或参数格式错误
在Python文件操作中，经常遇到 [Errno 22] Invalid argument: '文件路径非法或参数格式错误' 的报错。该错误通常出现在使用 open()、os.listdir()、shutil 等文件操作函数时，传入了非法文件路径或格式不正确的参数。
这类错误通常与路径字符串的格式、编码、合法性密切相关，尤其在跨平台开发中容易被忽视。
二、常见原因分析路径中包含非法字符：如 *, ?, <, > 等，未进行正确转义。
路径字符串编码问题：在不同操作系统或文件系统中使用了不兼容的编码格式。
路径为 None 或空字符串：函数参数未校验，直接传入空值。
路径格式不正确：特别是在Windows系统中未正确使用双反斜杠 \\ 或原始字符串 r''。
路径长度超出系统限制：如Windows系统中路径长度超过 260 字符限制。
三、排查与解决步骤检查路径来源：确认路径是否由用户输入、配置文件或第三方接口传入，是否可能包含非法字符或空值。
转义路径字符串：使用 os.path 模块拼接路径，避免手动拼接错误。
使用原始字符串处理路径：特别是在Windows路径中使用 r'C:\path\to\file'。
路径合法性校验：使用 os.path.exists() 或正则表达式校验路径格式。
异常捕获机制：使用 try-except 捕获 OSError 或 FileNotFoundError，提升程序健壮性。
四、代码示例与最佳实践 import os import shutil # 使用 os.path 拼接路径 base_dir = r'C:\Users\test' file_name = 'example.txt' full_path = os.path.join(base_dir, file_name) # 路径合法性校验 if os.path.exists(full_path): try: with open(full_path, 'r') as f: print(f.read()) except OSError as e: print(f"文件操作失败：{e}") else: print("路径不存在或非法") 五、路径处理常见陷阱与规避策略 陷阱类型说明规避策略