文件存在却报File not found error、无法修改文件路径的原因及解法

「Unable to modify file path（无法修改文件路径）」异常 #

常见触发原因 #

• 目标文件/路径被其他进程锁定：文件正被编辑器、资源管理器预览窗格、云同步工具、杀毒软件占用时，系统会拦截路径修改操作
• 操作权限不足：当前账号对目标路径所在目录没有写入/修改权限，系统盘核心目录、外接存储、局域网共享文件夹场景高发
• 路径不符合规则：修改后的路径包含/ \ : * ? " < > |这类系统禁止的特殊字符，路径总长度超过系统限制（Windows默认单路径最长260字符），或目标路径指向光盘、写保护U盘这类只读介质
• 文件系统损坏：对应分区存在文件系统错误、残留损坏的软链接/挂载点，导致路径寻址异常

修复方案 #

• 关闭所有可能打开目标文件的程序，打开系统资源监视器，在「CPU」标签页下的「关联的句柄」搜索框输入目标文件名，结束所有搜索到的占用进程后重试
• 右键点击目标路径所在目录，打开「属性-安全」面板，给当前登录账号勾选「完全控制」权限；外接存储先检查设备物理写保护开关是否处于开启状态
• 排查修改后的路径字符串，删除非法特殊字符，缩短上层文件夹名称减少路径总长度，不要将目标路径设置到只读存储介质上
• 以管理员身份打开终端，执行chkdsk 对应盘符 /f扫描修复分区文件系统错误，按提示重启电脑完成修复

文件真实存在但触发「File not found error（文件未找到错误）」异常 #

常见触发原因 #

• 路径转义错误：代码/脚本中编写的Windows路径没有处理反斜杠转义，比如字符串里的\n \t会被识别为转义字符，导致程序实际访问的路径和真实路径不一致
• 扩展名被隐藏：系统默认开启「隐藏已知文件类型的扩展名」，肉眼看到的demo.txt实际可能是demo.txt.md、demo.txt.exe，程序按可见名称查找无法匹配真实文件
• 权限隔离拦截：Windows UAC安全机制下，普通权限运行的程序访问管理员创建的受保护文件时，不会返回权限不足提示，而是直接抛出文件不存在错误
• 编码不匹配：路径包含中文、emoji、小语种特殊字符时，程序使用的编码（如GBK、ASCII）和系统文件系统编码（UTF-8）不一致，会导致路径解析乱码无法定位文件
• 大小写校验冲突：WSL、跨平台移植的程序默认开启路径大小写敏感校验，文件名大小写不匹配时也会报找不到文件

修复方案 #

• 代码中编写路径优先使用原始字符串格式（如Python路径前加r前缀），或统一用正斜杠/作为路径分隔符；调试时先打印程序解析出的最终路径，和真实路径逐字符比对
• 打开文件资源管理器「查看」选项卡，勾选「文件扩展名」显示，确认程序中填写的文件名（含后缀）和真实文件完全一致
• 右键点击运行的程序/脚本，选择「以管理员身份运行」后重试；尽量不要把操作的文件放在Program Files、System32这类系统受保护目录，挪到非系统盘的普通用户目录下操作
• 代码中指定文件操作的编码为utf-8；Windows系统可打开「区域设置-管理-更改系统区域设置」，勾选「Beta版：使用Unicode UTF-8提供全球语言支持」，重启后解决非ASCII路径解析问题
• WSL/跨平台场景下，在终端执行fsutil.exe file setCaseSensitiveInfo 目标路径 disable关闭对应目录的大小写敏感校验，同时保证代码中填写的文件名大小写和真实文件完全匹配

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