Skip to content

免费工具

LaTeX 错误解读

粘贴 LaTeX 日志或单条错误信息。工具会找出第一个真正的错误,指出所在行,用通俗的语言解释原因,并说明如何修复。它还会将警告分组:未定义的引用和交叉引用、溢出的盒子(overfull box)、缺失的字符。无需注册账号。

粘贴完整的 .log 文件效果最好,但单条错误信息也可以。日志只保留在您的浏览器中。

2. 查看出错原因

在左侧粘贴日志,或点击示例查看效果。

编译试试

无需安装任何软件即可测试修复

LaTeX Cloud Studio 会在浏览器中打开一篇入门文章,并提供完整的 TeX Live。将文档中出错的部分粘贴到 main.tex 中,在那里编译即可。

如何阅读 LaTeX 错误

日志中的错误由三部分组成。以 ! 开头的行说明问题,例如 ! Undefined control sequence.。以 l. 加数字开头的行给出源文件中的行号以及 LaTeX 已读取的文本。该源代码行的其余部分会缩进显示在日志的下一行。两行之间的断开处正是 LaTeX 停下的位置。

工具会读取每个错误的这三部分,能识别三十多种常见信息,并把第一个真正的错误放在最上面。Emergency stop 之类的信息只表示运行已经结束;真正的原因是它们之前的错误。

最常见的错误

  • Undefined control sequence: 命令拼写错误,或其所属的宏包未加载。对于常见命令,工具会指出所需的宏包,例如 \includegraphics 需要 graphicx。
  • Missing $ inserted: 普通文本中出现了下划线、^ 或数学命令。
  • File not found: 宏包名、图片路径或 \input 路径与实际文件不符。
  • Runaway argument: 缺少右花括号。
  • Misplaced alignment tab character &: 文本中的 & 符号必须写成 \&。

各类问题的指南

常见问题

在哪里可以找到 LaTeX 日志?

LaTeX 会在同一文件夹中写入一个与主文件同名、扩展名为 .log 的文件,例如 main.log。编辑器会在日志或输出面板中显示它。复制全部文本,或者只复制第一个以感叹号开头的行前后的几行。

应该先修复哪个错误?

第一个。出错后,LaTeX 会猜测如何继续,而这种猜测常常在后面引发更多错误,修复第一个错误后它们就会消失。每次修复一个错误,重新编译,然后重复。

日志中的“l.12”是什么意思?

它是 LaTeX 发现问题时正在读取的文件中的行号。数字后面的文本是 LaTeX 在该行已读取的内容。原因可能出现在更前面:缺少的右花括号会在 LaTeX 放弃寻找它的位置才被报告,那可能是段落末尾,也可能是文件末尾。

为什么有错误却仍然生成了 PDF?

编辑器以出错后继续运行的模式运行 LaTeX。LaTeX 会跳过或修补出错的部分并处理完整个文件,因此 PDF 虽然生成了,但在这些位置是错的。即使 PDF 看起来没问题,也请把每个错误都当作需要修复的问题。

错误和警告有什么区别?

错误表示 LaTeX 无法完成源代码要求的操作。警告表示 LaTeX 完成了操作,但结果可能不是您想要的:引用显示为问号、某一行伸进页边距、图片位置发生了移动。先修复错误,再在提交前查看警告。

我的日志会被上传吗?

不会。日志在您的浏览器中由匹配错误信息的规则读取。不会向任何服务器发送内容,也没有 AI 模型读取它。