DOC2X使用指南

LaTeX 图片不显示:文件、路径与编译检查

用真实 PDF 导出的 TeX 与 JPG 复现缺图错误:只有源码时无法编译,恢复图片目录后成功。提供原始 ZIP、实际日志和编译 PDF,区分文件路径、错误引擎、草稿预览及图表文字遗漏。

你的文件
TeX 源码与它引用的图片文件
得到什么
可显示图片的编译结果,再对照原稿检查
实际 TeX 包内的 JPG,显示三个数据点与横轴;原图顶部距离单位说明没有进入这张图片
实际 TeX 包内的 JPG,显示三个数据点与横轴;原图顶部距离单位说明没有进入这张图片
本页内容

从缺失文件定位,恢复原目录后再编译

  1. 先备份工程,打开编译日志,区分找不到文件、字体或引擎错误,以及单纯的预览问题。
  2. 检查压缩包里是否有配套图片,不要只复制 TeX。确认主文档所在位置与图片目录关系。
  3. 把原图片按源码路径补回。本例恢复 images 目录,保留文件名与 TeX 原文。
  4. 使用合适的编译器重新编译。这份原包的本地通过方式为 XeLaTeX;有 fontspec 错误时先解决引擎问题。
  5. 查看新 PDF 并核对图表标题、坐标轴、单位和图注。文件路径修复后,仍需处理识别遗漏。
用完整样例核对图片路径

已有 TeX 时不必重新上传 PDF;下面的失败场景是在实际导出包的本地副本中有意复现。

同一原包:缺图失败,恢复文件后通过

先用实际 Doc2X 导出包完成本地编译,再在单独副本中只保留 TeX、遗漏图片,复现下面的错误。随后补回原 JPG,TeX 不作修改,重新编译成功。图像本身仍保留实际识别时的裁取范围。

输入第 2 页:包含图表顶部单位说明
原 PDF 第二页,图表上方显示 Distance s (m) 与恒定速度说明,另有三个数据点和图注查看原图 ↗
本地编译第 2 页:图像存在,顶部说明缺失
原始 TeX 编译第二页显示折线图与图注,但缺少原图上方的距离单位与恒定速度说明查看原图 ↗

实际缺图编译日志(节选)

! Unable to load picture or PDF file 'images/1_279_471_1061_604_0.jpg'.
  1. 错误测试只改变本地副本中的图片文件是否存在,没有重新提交 OCR,也没有改写原 TeX。
  2. 缺图时 XeLaTeX 退出码为 1,没有生成 PDF;恢复原图片后退出码为 0,得到两页 PDF。
  3. 恢复后的 PDF 正文与完整包的编译结果一致;其图像 JPEG 流也与原始包内图像字节一致。
  4. 原 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 · 功能条件与配额以当前产品界面为准