PS C:\Users\Lenovo> & D:/anaconda3/python.exe "c:/Users/Lenovo/Desktop/import fitz # 这实际上是 PyMuPDF 的别名.py" Traceback (most recent call last): File "c:\Users\Lenovo\Desktop\import fitz # 这实际上是 PyMuPDF 的别名.py", line 3, in <module> doc = fitz.open("example.pdf") # 打开 PDF 文档 ^^^^^^^^^^^^^^^^^^^^^^^^ File "D:\anaconda3\Lib\site-packages\pymupdf\__init__.py", line 2918, in __init__ raise FileNotFoundError(msg) pymupdf.FileNotFoundError: no such file: 'example.pdf'

### PyMuPDF 打开 `example.pdf` 文件时出现 FileNotFoundError 的解决方案 当使用 PyMuPDF 尝试打开一个 PDF 文件并遇到 `FileNotFoundError` 时，这表明程序无法定位到目标文件。以下是可能导致此问题的原因以及相应的解决方法： #### 可能原因分析 1. **文件路径错误** 如果提供的文件路径不正确，则会导致找不到文件的情况发生。例如，在 Windows 系统上，反斜杠 `\` 需要被转义为双反斜杠 `\\` 或者替换为正斜杠 `/` 来避免解析错误[^2]。 2. **文件不存在** 若指定路径下的文件确实不存在，可能是由于文件已被移动、重命名或删除所致。需要确认文件的实际存储位置是否与代码中定义的路径一致。 3. **文件名或扩展名错误** 输入的文件名可能含有拼写错误、多余的空格或者其他不可见字符。此外，某些操作系统对大小写敏感，因此即使文件存在也可能因大小写不符而报错。 4. **权限不足** 当前运行环境可能缺乏读取特定目录或文件所需的权限。这种情况下即便文件存在于给定路径也无法成功加载。 #### 解决方案实现 为了有效处理上述各种潜在问题，可以采取如下措施来修正代码逻辑： - **验证文件是否存在** 通过标准库 os.path 模块先检测文件的存在状态再继续执行后续操作。 ```python import fitz # 导入 PyMuPDF 库 from pathlib import Path file_path = Path("example.pdf") if not file_path.is_file(): raise FileNotFoundError(f"The specified document does not exist at {file_path}") doc = fitz.open(str(file_path)) # 使用字符串形式传参以兼容不同平台差异 print(doc.metadata) # 输出文档元数据作为测试反馈 ``` - **调整路径分隔符** 确保跨平台上都能正常识别路径结构，推荐采用 pathlib 提供的方法构建绝对路径对象。 ```python from pathlib import Path base_dir = Path(__file__).parent.resolve() # 获取当前脚本所在目录 target_pdf = base_dir / "resources/example.pdf" # 构造子目录内的资源链接 assert target_pdf.exists(), f"{target_pdf} missing!" document = fitz.open(target_pdf.as_posix()) # 转换为 POSIX 字符串适配更多场景 ``` - **捕获异常增强健壮性** 引入 try-except 块包裹易出现问题部分以便更好地控制流程走向。 ```python try: doc = fitz.open("nonexistent_example.pdf") except Exception as e: error_message = str(e) if "[Errno 2]" in error_message: # 特定错误码判断 print("Document could not be found.") else: print(f"Some other issue occurred:{error_message}") finally: pass # 清理工作可放在此处 ``` 以上三种方式分别针对不同的实际需求提供了灵活应对策略，可以根据具体应用场景选择合适的做法加以应用。 ### 注意事项 始终记得检查所使用的文件路径是否准确无误；对于生产环境中部署的应用还需考虑安全性因素如防止任意文件读取漏洞等问题的发生。