错误与警告列表

这是一份 LaTeX 消息速查表。错误(!)会停止构建;警告 不会停止构建,但常常提示真实问题(坏掉的行、损坏的引用)。下面列出常见消息、含义和典型处理。(如何阅读以及 ? 提示符,见“读取错误与调试”。)

TeX 错误

消息原因与处理
! Undefined control sequence未知命令:拼写错误,或未加载宏包
! Missing $ inserted在数学模式外使用数学符号;用 $...$ 包起来
! Too many }'s}{
! Missing } inserted{ 没有闭合
! Misplaced alignment tab character &在表格外使用了 &;正文中的字面量用 \&

LaTeX 错误

消息原因与处理
LaTeX Error: File not found缺少宏包/文件:用 tlmgr 安装并检查拼写
Environment undefined未定义环境:未加载宏包或拼写错误
\begin{x} ended by \end{y}\begin/\end 不匹配或嵌套交叉
Something's wrong--perhaps a missing \item空列表,或第一个 \item 前有文本
Command \x already defined重新定义已有命令;使用 \renewcommand

LaTeX 警告

消息含义与处理
Overfull \hbox一行超出右边距:改写、断字,或局部使用 \sloppy
Underfull \hbox行距过松(badness):改写或调整换行
Reference undefined\ref/\label 不一致,或需要再编译一次
Citation undefined未知文献键,或未运行 bibtex/biber
Label multiply defined同一标签定义了两次
Font shape undefined字体声明错误或未安装;会用默认字体替代

常见误用

  • $ 未闭合 → 数学模式会失控。务必成对使用。
  • & 过多 → 与表格列数匹配;正文中的字面量用 \&
  • 误用 \\ → 段落分隔用空行;最后一行或标题后不需要 \\
  • 括号 { } 不匹配 → 用编辑器的括号匹配功能快速查找。