本页内容
从缺失文件定位,恢复原目录后再编译
- 先备份工程,打开编译日志,区分找不到文件、字体或引擎错误,以及单纯的预览问题。
- 检查压缩包里是否有配套图片,不要只复制 TeX。确认主文档所在位置与图片目录关系。
- 把原图片按源码路径补回。本例恢复 images 目录,保留文件名与 TeX 原文。
- 使用合适的编译器重新编译。这份原包的本地通过方式为 XeLaTeX;有 fontspec 错误时先解决引擎问题。
- 查看新 PDF 并核对图表标题、坐标轴、单位和图注。文件路径修复后,仍需处理识别遗漏。
已有 TeX 时不必重新上传 PDF;下面的失败场景是在实际导出包的本地副本中有意复现。
同一原包:缺图失败,恢复文件后通过
先用实际 Doc2X 导出包完成本地编译,再在单独副本中只保留 TeX、遗漏图片,复现下面的错误。随后补回原 JPG,TeX 不作修改,重新编译成功。图像本身仍保留实际识别时的裁取范围。
实际缺图编译日志(节选)
! Unable to load picture or PDF file 'images/1_279_471_1061_604_0.jpg'.- 错误测试只改变本地副本中的图片文件是否存在,没有重新提交 OCR,也没有改写原 TeX。
- 缺图时 XeLaTeX 退出码为 1,没有生成 PDF;恢复原图片后退出码为 0,得到两页 PDF。
- 恢复后的 PDF 正文与完整包的编译结果一致;其图像 JPEG 流也与原始包内图像字节一致。
- 原 PDF 图表上方的“Distance s (m) | Constant-speed model: s = 3t”没有进入导出的 JPG 或 TeX 正文。三个点的标注和横轴仍可见;纵向距离的单位应回到原 PDF 核对。恢复图片路径只解决文件缺失,不会补回这行识别内容。
这是一份清晰的英文电子 PDF。原始 ZIP、TeX 和 JPG 均未改写,编译 PDF 由本地 XeLaTeX(TeX Live 2023)生成;本轮没有上传或在 Overleaf 云端编译。日志有字体替换和页边注释相关警告,标题字体、表格边框与分页发生变化。扫描件、手写、中文排版、参考文献数据库和原作者自定义宏未由本例验证。
先了解这几件事
先确认图片文件真实存在,再核对 TeX 中的路径和编译器。本例只有源码、没有 images 目录时,XeLaTeX 报告图片无法载入;补回原 JPG 后恢复编译,TeX 一字未改。若图片已显示但缺标题或单位,则要检查识别内容,重复改路径不会补回漏行。
- 实际复现
- 同一份原始 TeX:遗漏图片时失败,补回原图片后成功。
- 目录关系
- TeX 与 images 目录放在同一级,图片名称以原包为准。
- 错误顺序
- 先解决 fontspec 等前置错误,再检查图片无法载入。
- 内容核对
- 图片存在与图表信息完整是两件事;本例顶部单位说明缺失。
常用语法,逐段对照
原 TeX 中的实际图片引用
\includegraphics[max width=0.9\textwidth]{images/1_279_471_1061_604_0.jpg}保持与原包一致的目录和文件名。此导出的完整前言已加载图片与尺寸相关宏包;复制这一行到其他模板时,也要核对所需宏包。
文件恢复后仍需内容校对:补充单位的示意
Distance \(s\) (m); constant-speed model: \(s=3t\).这是对照原 PDF 后可添加的说明示例,不是原始导出内容,也没有暗中写入本页下载文件。它补充阅读信息,不会修复已经裁取的图像本身。
先分清“没有图片”的原因
| 现象 | 应先核对 | 本页证据范围 |
|---|---|---|
| 无法载入某个图片文件 | 目录、文件名与完整解压 | 本地缺图与恢复已实测 |
| fontspec 要求其他引擎 | 所用 LaTeX 编译器 | pdfLaTeX 失败、XeLaTeX 通过已实测 |
| 预览中没有图片但文件存在 | Normal / Fast [draft] 与查看器 | 依据 Overleaf 官方说明,未作云端实测 |
| 图像显示但标题或单位缺失 | 与原 PDF 的内容差异 | 本例确有图表顶部说明遗漏 |
先确认图片真的在工程里
相对路径只告诉编译器去哪里找文件,不会把图片内容自动写入 TeX。本例原始 ZIP 有一份 TeX 和一张 JPG;只复制源码会遗漏那张图片。
从主文档位置核对路径
把 TeX 与原 images 目录一起解压,逐项核对路径、大小写与扩展名。若调整目录结构,要同步修正引用;先用原包结构成功编译,再迁移到自己的多文件工程。
不要把前置错误当成图片问题
本例用 pdfLaTeX 时,fontspec 已经报错,尚未处理到图片。先处理最前面的有效错误;切换到合适引擎后再定位具体缺失文件。
区分草稿模式与文件缺失
Overleaf 官方说明中,Fast [draft] 模式可能不显示插图,查看器也可能造成仅预览异常。可以按官方步骤检查 Normal 模式和下载的 PDF;这类现象与本页有意遗漏图片的本地测试不同。
图片加载成功后,回到原稿核对
原 PDF 图表上方的“Distance s (m) | Constant-speed model: s = 3t”没有进入导出的 JPG 或 TeX 正文。三个点的标注和横轴仍可见;纵向距离的单位应回到原 PDF 核对。恢复图片路径只解决文件缺失,不会补回这行识别内容。
相关官方说明
遇到这些情况
- 重新导出仍然缺图
- 先检查是否又只复制了源码,或解压后移动了图片目录。对于本例的缺失文件问题,补回原图即可,无需重复 OCR。
- 改路径后仍提示 fontspec 错误
- 先核对编译器。此原包在本地用 XeLaTeX 通过,pdfLaTeX 在图片处理之前失败。
- 图片能显示,但图表单位不见了
- 检查原 PDF 与实际图像裁取范围。本例的顶部说明已在导出阶段遗漏,需要单独补充内容;改路径无法恢复。
常见问题
LaTeX 图片不显示,需要重新识别 PDF 吗?
如果只是缺少配套图片或路径不匹配,不需要。本例恢复原 JPG 后,未改写 TeX 就能编译。
为什么只拿 TeX 文件不能显示图片?
本例图片通过相对路径引用,内容保存在独立 JPG 中。需要同时保留 images 目录。
能生成 PDF,就能证明图片内容完整吗?
不能。本例成功编译仍缺少原图顶部单位说明。应查看图像内容并对照原 PDF。
本页复现了 Overleaf 云端缺图吗?
没有。失败与恢复在本地 XeLaTeX 测试,云端草稿模式与查看器部分引用官方排查说明。
内容核对:2026-10-11 · 功能条件与配额以当前产品界面为准


