跳到正文

整个文档无法排版时

能让整个文档停止排版的情况很少:无法读取的公式会以红色显示,并在“问题”标签页中列出;\partial、\langle、\oplus、\hbar 和 Vmatrix 的排版与 LaTeX 中一样。目前唯一已知的原因是 EPS 图片,请把它转换为 PDF、PNG 或 SVG。

你看到的现象

通常,某处的问题只会影响那一处:未知命令会被跳过,无法读取的公式会以红色显示,文档的其余部分照常排版。如果整个文档都失败了,预览不会显示新的页面,顶部的错误栏会指出出错的原因。

仍会让文档停止排版的情况

已知的原因只有一个:带扩展名引入的 EPS 图片,例如 \includegraphics{figure.eps}。错误信息为 unknown image format。请把文件转换为 PDF、PNG 或 SVG,并修改 \includegraphics 中的文件名。故障排除中有一个示例。

要在长文档中找到出错的行,请查看错误信息中的行号,或者用 % 注释掉一半的文档,看看页面是否恢复显示。然后对仍然失败的那一半重复这个过程。

公式永远不会让文档停止排版

如果某个公式使用了数学转换器不认识的命令,或者括号不匹配,转换器无法读取它,该公式就会以红色显示其源代码。“问题”标签页会列出它及其所在的行,例如“This formula could not be read: \symbf{v} (unknown command: \symbf)”。前十个这样的公式会被逐一列出,之后再用一行显示其余公式的数量。红色公式上的 \label 不会定义任何标签,所以指向它的 \eqref 会输出 ??,并与缺失的标签一起列出。常用的替代写法请参阅红色公式。

以前会让文档停止排版的命令

在早期版本的 Scissor LaTeX 中,有一组数学命令会让整个文档停止排版,因为排版库重命名了它们对应的符号名称,错误信息例如 unknown variable: diff 或 unknown symbol modifier。现在它们都能排版,写法与 LaTeX 中完全相同:

\partial 可以排版

\frac{\partial f}{\partial x}

\langle 和 \rangle 可以排版,在 \left 和 \right 之后也可以

\langle u, v \rangle, \quad \left\langle \frac{a}{b} \right\rangle

\oplus 和其他带圈运算符可以排版

V \oplus W, \quad A \otimes B, \quad \bigcap_{i} A_i

已修复的命令包括:\partial;\langle、\rangle、\lang、\rang;\cap、\bigcap、\Cap、\doublecap、\sqcap;\oplus、\ominus、\otimes、\odot 及其大型形式;\circledast、\circledcirc、\circleddash;\llbracket、\rrbracket;\hbar、\hslash、\mho;\dashleftarrow、\dashrightarrow;\bra、\ket、\braket;内置的 \argmax 和 \argmin;Vmatrix 环境;以及公式中的 \hspace*。如果你曾用 Unicode 字符替换过其中某些命令,可以保留这些字符,也可以改回命令。

Unicode 字符同样可用

Scissor LaTeX 也接受直接写在公式中的 Unicode 数学字符。⟨ 和 ⟩ 等定界符会随 \left 和 \right 自动伸缩。

用 Unicode 字符写的相同公式

\frac{∂ f}{∂ x}, \quad ⟨ u, v ⟩, \quad \left⟨ \frac{a}{b} \right⟩,
\quad V ⊕ W, \quad A ∩ B, \quad ℏ \omega

Unicode 字符和自定义的运算符

\documentclass{article}
\usepackage{amsmath}
\DeclareMathOperator*{\argmax}{arg\,max}
\begin{document}
\[
  ⋂_{i=1}^{n} A_i, \quad ⨁_{i} V_i, \quad ⟦ x ⟧, \quad
  ⟨ \psi \vert \phi ⟩, \quad a ⇢ b, \quad
  \argmax_{x} f(x), \quad
  \begin{Vmatrix} a & b \\ c & d \end{Vmatrix}
\]
\end{document}
由 Scissor LaTeX 排版: Unicode 字符和自定义的运算符

使用 XeLaTeX 或 LuaLaTeX 以及 unicode-math 宏包的 TeX 发行版可以直接读取这些字符。使用 pdfLaTeX 时,请在导言区用 \DeclareUnicodeCharacter 告诉 LaTeX 每个字符的含义。Scissor LaTeX 会接受这些行并忽略它们,所以同一份源代码在两边都能使用:

同一份源代码适用于 Scissor LaTeX 和 pdfLaTeX

\documentclass{article}
\usepackage{amsmath}
\DeclareUnicodeCharacter{2202}{\partial}
\DeclareUnicodeCharacter{27E8}{\langle}
\DeclareUnicodeCharacter{27E9}{\rangle}
\DeclareUnicodeCharacter{2295}{\oplus}
\begin{document}
The gradient has the parts $\frac{∂ f}{∂ x_i}$, the inner product
is $⟨ u, v ⟩$, and the sum is $V ⊕ W$.
\end{document}
由 Scissor LaTeX 排版: 同一份源代码适用于 Scissor LaTeX 和 pdfLaTeX

完整列表

下面的列表在构建网站时生成:排版引擎表中的每个数学命令都会单独放在一个公式中试排,所有无法正常工作的命令都会连同其结果一起列出。当某个命令在引擎中被修复后,它会自动从这个列表中消失。

目前没有:表中全部 789 个数学命令都能单独在公式中排版。

常见问题

为什么我的 LaTeX 文档完全无法排版?

已知的唯一原因是 EPS 图片。请把它转换为 PDF、PNG 或 SVG,并修改 \includegraphics 中的文件名。含有未知命令的公式不会让文档停止排版;它会以红色显示,并在“问题”标签页中列出。

\partial 在 Scissor LaTeX 中可以用吗?

可以。\partial、\langle、\rangle、\oplus、\otimes、\hbar 和 Vmatrix 在早期版本中曾会让整个文档停止排版;现在它们的排版与 LaTeX 中一样。

“unknown symbol modifier”是什么意思?

早期版本在遇到 \langle、\oplus 或 \hbar 等命令时会显示这条消息,因为排版库重命名了它们的符号名称。这些命令现在都能正常工作。如果你仍然看到这条消息,请刷新编辑器以获取最新版本。

本页的每个示例都在构建网站时由 Scissor LaTeX 排版。 最后更新:2026-11-07