常见错误及其解决方法
大多数问题都不会让文档停止排版：未知命令会被跳过并列在“问题”标签页中，无法读取的公式以红色显示并在那里注明，缺失的图片或引用会在原处标出；只有 EPS 图片会让整个文档停止排版。
问题是如何报告的
TeX 发行版遇到第一个错误就会停下来，问你该怎么办。Scissor LaTeX 则会继续：它尽可能多地排版文档，并把无法处理的内容列在预览下方的 “问题” 标签页中。在已知位置的情况下，每一项都会注明对应的行，点击即可跳转过去。
结果分为四种：
| 你看到的 | 含义 | 去哪里查看 |
|---|---|---|
| “问题”标签页中有消息，文档正常 | 有内容被跳过或略去。 | 下面各节。 |
| 某个公式显示为红色源代码 | 这个公式无法读取。 | 红色公式 |
红色的 [key?] 或灰色虚线框 | 缺少引用或图片。 | 缺失的引用和图片 |
| 完全没有页面，顶部显示错误 | 整个文档失败了。 | 整个文档无法排版时 |
“Skipped N unknown commands”
这是你最常看到的消息，相当于 LaTeX 的“Undefined control sequence”。Scissor LaTeX 不认识的命令会被跳过：命令名消失，花括号中的文字保留。
未知命令：命令名消失，文字保留
The value is \highlightvalue{44} and the unit is \unitname{kg}.“问题”标签页： Skipped 2 unknown commands: \highlightvalue, \unitname
该怎么做：
- 检查拼写。
\textbf可用，\textbold不可用。 - 如果命令来自某个宏包，请在宏包页面中查找这个宏包。有些命令有简单的替代写法。
- 如果是你自己的命令，请确认它在使用之前已经用
\newcommand定义（参见自定义命令）。
未知的 环境 则不同：它会被静默移除，内容保留，不会给出任何消息。如果文字看起来没有格式，请检查环境名。
“Package ... is not available here”
\usepackage 从不失败。Scissor LaTeX 不认识的宏包会在“问题”标签页中注明，它的格式不会被应用。文档的其余部分照常排版，而该宏包中不被认识的命令会作为未知命令报告。
不可用的宏包
\documentclass{article}
\usepackage{fancyboxes2}
\begin{document}
The document still typesets.
\end{document}“问题”标签页： Package fancyboxes2 isn't supported in the preview, so its formatting is not applied. If it is your own package, add fancyboxes2.sty to the project.
红色公式
当公式中含有数学转换器无法读取的内容时，这个公式会显示为红色源代码。文档的其余部分不受影响。“问题”标签页会注明该公式、所在行和原因，例如“This formula could not be read: \symbf{v} (unknown command: \symbf)”；超过十个公式后，会再用一行给出其余公式的数量。
\symbf 不可用，所以公式显示为红色
The vector $\symbf{v}$ is shown in red,
while $\boldsymbol{v}$ next to it works.以红色显示： 无法读取公式，因此改为显示其源代码。
常见原因和解决方法：
| 原因 | 解决方法 |
|---|---|
\abs{x}, \norm{x}, \dv{f}{x} (physics) | \left\lvert x \right\rvert, \left\lVert x \right\rVert, \frac{df}{dx} |
\SI{44}{\kilo\gram} (siunitx) | 44\,\mathrm{kg} |
\sideset | 不用它重写公式。 |
没有配对的 $ | 闭合公式。未闭合的 $ 不会变红：它会把所在段落的其余部分（直到下一个空行）变成挤在一起的斜体数学内容。 |
缺失的引用和图片
不在任何 .bib 文件中的引用键会显示为红色的 [key?]，“问题”标签页会列出缺失的键。缺失的图片会变成一个带文件名的灰色虚线框。
不在项目中的图片
\begin{figure}[h]
\centering
\includegraphics[width=0.5\linewidth]{figures/plot.png}
\caption{A plot that has not been uploaded yet.}
\end{figure}
“问题”标签页： Images not in the project: figures/plot.png
请把文件按相同的路径上传到项目中，或者修正路径。不写扩展名时，会查找 .png、.jpg、.jpeg 和 .svg 文件；PDF 和 EPS 图同样显示为虚线框（参见图与图片）。关于引用，请参阅参考文献与引用。
其他消息
| 消息 | 含义 | 该怎么做 |
|---|---|---|
| “N included files are not part of this conversion” | \subfile、\import、\lstinputlisting、\inputminted 或 \includepdf 被跳过了。 | 使用 \input，或者把内容粘贴进来。 |
| “File not found: ...” | \input 或 \include 指定的文件不在项目中。 | 从项目的顶层文件夹开始检查路径。 |
| “N pictures of an unsupported kind are not included” | tikzcd、circuitikz、forest 或 picture 环境被略去了。 | 参见用 TikZ 绘图。 |
| “TikZ option '...' is not supported yet” | 图片用到了绘图引擎不认识的选项。图片会在不使用该选项的情况下绘制。 | 检查这个选项，或者去掉它。 |
| “Layout in the style of ... Not official.” | 会议文档类或宏包切换到了仿制版式。 | 无需处理；这只是提示信息。 |
| “Macro expansion stopped at the safety limit” | 某个命令展开成了它自身，或展开成了大量文本。 | 查找使用了自身名称的 \newcommand。 |
| “This formula could not be read: ...” | 公式以红色显示；原因写在括号中。 | 参见红色公式。 |
| “References to labels that do not exist (shown as ??): ...” | \ref、\eqref、\pageref 或 \cref 指定的标签没有定义，或者位于红色公式上。 | 检查标签的拼写。 |
| “Bibliography style ... is not available; using numbered references [1] instead” | \bibliographystyle 指定的样式不在列表中，例如 alpha。 | 从列表中选一个样式，或者保留编号引用。 |
| “Skipped .bib entries: ...” | .bib 文件中的这些条目无法读取（缺少花括号、键重复）；其他条目照常使用。 | 修正所给行号处的条目。 |
在这里看不到的 LaTeX 错误
有些经典的 LaTeX 错误在 Scissor LaTeX 中不会让任何东西停下来，因此很容易被忽略：
| LaTeX 错误 | Scissor LaTeX 的处理 |
|---|---|
正文中的 x_1 引发“Missing $ inserted” | 按字面输出 x_1。请把数学内容放在 $...$ 中。 |
| “Misplaced alignment tab character &” | 按字面输出 &。要输出和号，请写 \&。 |
| “Extra }, or forgotten $” | 忽略不配对的花括号。 |
| “\begin{itemize} ended by \end{document}” | 替你闭合该环境。 |
| “Reference ... undefined” | 输出粗体的 ??；“问题”标签页会列出缺失的标签。 |
LaTeX 会拒绝的文本
Fish & chips cost 44 dollars, and x_1 is not a formula here.
Write Fish \& chips and $x_1$ instead.这些文档在 TeX 发行版中仍可能失败，所以即使预览看起来没问题，也请修正它们。
与 TeX 发行版的区别
按症状排查的清单，请参阅故障排除。
常见问题
“Undefined control sequence”是什么意思？
LaTeX 不认识某个命令，通常是因为拼写错误或缺少宏包。在 Scissor LaTeX 中，同样的情况会在“问题”标签页中显示为“Skipped N unknown commands”，文档仍会排版。
为什么我的公式是红色的？
公式中含有数学转换器不认识的命令，例如 \symbf 或 \abs。“问题”标签页会注明它。请替换这个命令；本页的表格列出了常见的替代写法。
为什么我的文档中出现 [key?]？
项目的任何 .bib 文件中都没有这个引用键。请检查拼写，并确认 .bib 文件已经上传。
本页的每个示例都在构建网站时由 Scissor LaTeX 排版。 最后更新：2026-11-07