这是一份 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 | 字体声明错误或未安装;会用默认字体替代 |
常见误用
$ 未闭合 → 数学模式会失控。务必成对使用。& 过多 → 与表格列数匹配;正文中的字面量用 \&。- 误用
\\ → 段落分隔用空行;最后一行或标题后不需要 \\。 - 括号
{ } 不匹配 → 用编辑器的括号匹配功能快速查找。