UnicodeDecodeError因Python默认用UTF-8解码非UTF-8文件名导致，应改用bytes路径操作；FileNotFoundError常因Unicode规范化差异，需用unicodedata.normalize或glob匹配；PermissionError在Windows遇保留名如CON需重命名；os.scandir()中优先用entry.path而非entry.name。
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xff in position 0
这是最常遇到的异常，尤其在 Windows 上读取由旧程序（如某些 C++ 工具、嵌入式设备导出）生成的文件时。文件名本身没问题，但 os.listdir() 或 pathlib.Path.iterdir() 在底层调用系统 API 后，Python 试图用 UTF-8 解码字节序列失败——因为原始文件名是 GBK、Shift-JIS 或纯二进制编码的。
根本原因不是文件名“非法”，而是 Python 默认把目录枚举结果当作 UTF-8 字符串处理。解决思路不是改文件名，而是绕过字符串解码环节，直接操作字节路径：
- 用
os.listdir(b'.')（传 bytes 而非 str）返回字节列表，避免解码 - 对每个
bytes文件名，用os.fsdecode()尝试安全转为 str；若失败，保留原字节或用os.fsencode()反向还原 - 打开文件时，也传
bytes路径给open()，例如open(b'\xff\xfe\x00\x00', 'rb')
FileNotFoundError: [Errno 2] No such file or directory: '测试①.txt'
看似文件存在，但 Path('测试①.txt').exists() 返回 False，或者 open() 报错。这通常是因为文件系统实际存储的是 Unicode 规范化形式（如 NFD），而 Python 字符串是 NFC —— macOS HFS+ 和某些 Linux mount 选项下容易出现。
实操建议：
- 先用
os.listdir()获取真实字节名，再用unicodedata.normalize('NFC', name)或'NFD'对比 - 不要硬编码文件名字符串，改用
glob模块匹配：list(Path().glob('测试*.txt'))更可靠 - 在 macOS 上，可临时禁用规范化：挂载时加
noapplexattr,nfc选项（需 root）
PermissionError: [Errno 13] Permission denied: 'CON.txt'（Windows）
这不是编码问题，而是 Windows 保留名冲突。即使文件名是合法 UTF-8 字符串，'CON'、'PRN'、'AUX' 等名字在任何目录下都无法被 Python 正常访问（系统级拦截）。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
这类问题在自动化脚本中特别隐蔽：
- 用
os.path.exists()检查会返回False，但os.listdir()可能列出它（取决于底层实现） -
shutil.move()或Path.rename()对这类名操作会直接抛PermissionError - 解决方案只有两个：重命名文件（如加下划线
'_CON.txt'），或用 Windows 原生 API（ctypes.windll.kernel32.CreateFileW）绕过检查（不推荐，复杂且易错）
os.scandir() 返回的 DirEntry.name 是乱码，但 .path 正常
在 Python 3.11 中，os.scandir() 的 DirEntry.name 属性是解码后的字符串，而 .path 是原始路径（可能含未解码字节）。当遇到无法解码的文件名时，.name 可能变成 '.txt' 或空字符串，但 .path 仍可用。
关键判断点：
- 永远优先用
entry.path构造新路径，而不是拼接entry.name - 若必须用名字做逻辑判断（比如过滤后缀），先检查
isinstance(entry.name, str)，否则跳过或用os.fsdecode(entry.name)安全转换 - 避免在循环中反复调用
entry.stat()—— 它可能触发额外解码，改用entry.inode()或缓存entry.stat(follow_symlinks=False)
真正麻烦的不是单个异常，而是多个机制叠加：比如一个文件名同时含 Windows 保留名 + 非 UTF-8 编码 + Unicode 规范化差异。这时候靠 try/except 捕获所有异常反而掩盖根源，得逐层用字节接口探查真实路径形态。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
