保存文件时无明确原因触发FileNotFoundError: [Errno 2] No such file or directory

排查与修复方案 #

1. 路径总长度超限问题 #

• Windows环境默认Win32路径最大长度为260字符（包含盘符、分隔符、文件名、末尾空字符），即便文件名本身无特殊字符，叠加前置路径后总长度超限就会触发写入失败。你可以先复制报错的完整路径统计字符数，确认是否触及上限。
  • 修复方案：Win10 1607及以上版本可开启系统长路径支持：运行gpedit.msc打开组策略，依次进入「计算机配置>管理模板>系统>文件系统」，启用「启用Win32长路径」后重启生效；也可以在代码传入的路径前添加\\?\前缀强制绕过长度限制，示例：\\?\C:\Users\demo\长路径\目标文件.txt
• Linux/macOS环境单文件名最大长度为255字节，总路径最大长度为4096字节，注意此处为字节数而非字符数，单个中文占3字节，很容易触发单文件名长度上限，可转换为UTF-8编码后统计字节数验证。

2. 文件名隐含不可见字符问题 #

肉眼观测无特殊字符的文件名，可能在复制/生成过程中携带了零宽空格、Unicode控制符、换行符等不可见内容，你可以将报错文件名复制到VS Code（开启「显示所有字符」开关）查看，或者通过代码遍历打印每个字符的Unicode编码确认是否存在异常。

• 修复方案：新增文件名清洗逻辑，用正则过滤所有控制类字符，参考过滤规则：[\x00-\x1F\x7F-\x9F\u200B-\u200F\uFEFF]

3. 文件句柄未释放问题 #

如果测试过程中生成过同名文件，且代码逻辑没有正确关闭文件流，残留的文件句柄会导致后续同名文件写入时报权限类错误。你可以在报错时通过系统工具检查对应路径是否被占用：Windows用资源监视器的「关联句柄」搜索，Linux用lsof命令查询。

• 修复方案：写文件逻辑优先使用语言自带的自动资源管理语法，比如Java的try-with-resources、Python的with open上下文管理器，避免手动关流遗漏导致句柄泄漏。

4. 大小写敏感冲突问题 #

Linux/macOS默认路径大小写敏感，Windows默认不敏感，但如果目标文件夹开启了大小写敏感属性也会触发相关校验。如果报错的文件名和已存在的文件仅大小写不同，且已存在的文件处于占用/只读状态，也会写入失败。

内容的提问来源于stack exchange，提问作者DoctorEvil