如何排查 LaTeX 公式渲染错误

对照错误与正确的 LaTeX 示例,修复括号和环境不匹配,区分渲染与导出问题,了解浏览器公式工具的支持范围。

2026-10-27
latex
错误排查
mathjax

公式渲染失败时,先缩减到能复现错误的最短表达式。可以从 x^2 开始,再逐步加回其他部分。转换器会在渲染前检查花括号和环境配对。出现跳转到错误按钮时,点击即可选中相关源码,方便定位。

1. 检查每组花括号是否闭合

分式需要分子和分母。下面的错误示例没有关闭分母的花括号:

\frac{a+b}{c

修正后:

\frac{a+b}{c}

多余的右花括号也会出错,例如应将 x^{2}} 改成 x^{2}。如果想在集合中显示花括号本身,应使用 \{ 和 \},而不是只用分组花括号:

A = \{1, 2, 3\}

2. 保持环境名称一致

环境的开头与结尾必须配对。下面用 bmatrix 开始,却以 pmatrix 结束:

\begin{bmatrix} 1 & 2 \\ 3 & 4 \end{pmatrix}

修正后:

\begin{bmatrix} 1 & 2 \\ 3 & 4 \end{bmatrix}

嵌套环境应按相反顺序关闭。如果错误出现在公式末尾,检查前面是否漏了对应的 \end{...}。

3. 将对齐标记放进相应环境

使用 & 标记对齐位置,使用两个反斜杠结束一行。直接把它们放在普通数学表达式中,可能导致报错或不符合预期的排版。

下面是可以完整使用的例子:

\begin{aligned}
(a+b)^2 &= (a+b)(a+b) \\
        &= a^2 + 2ab + b^2
\end{aligned}

仅在编辑器里按回车,不等于给数学公式添加换行。矩阵中使用 & 分列,并保持各行元素数量一致。示例库中有可直接使用的矩阵、多行对齐公式和分段函数。

4. 检查从其他文档复制的命令

未知命令可能来自拼写错误,也可能是原文档里定义的简写。例如,\RR 不是本转换器的标准简写,可以改成明确的表达式:

x \in \mathbb{R}

MathJax 支持 LaTeX 的一个子集,与完整 TeX 引擎有所不同。官方命令列表列出了命令及其宏包,但不代表本站启用了其中全部扩展。还可以参考 MathJax 与 TeX 的差异说明。

本工具处理的是公式片段。请移除 \documentclass、\usepackage 和文档外壳,只粘贴数学表达式。不支持完整 .tex 工程、TikZ 图形、任意宏包安装或 PDF 编译。

5. 区分渲染问题和导出问题

如果预览正确,修改括号通常无法解决剪贴板被阻止或 PNG 模糊的问题。按现象选择下一步:

现象建议处理
连 x^2 都提示 MathJax 加载失败刷新页面,检查浏览器扩展或网络设置是否拦截了站点脚本
只有某条公式报错缩短公式,检查括号、环境名称,再检查命令
预览正常但复制图片失败改用下载;浏览器剪贴板权限和支持情况可能不同
点击打开 SVG 没有反应检查新窗口是否被拦截,或选择 SVG 格式后下载
PNG 放大后模糊提高导出缩放倍数,或在目标程序支持时使用 SVG
JPG 出现白色背景JPG 不支持透明背景;改用 PNG 或 SVG
深色背景下看不到公式导出前将公式颜色改成浅色
栅格导出提示图片尺寸过大降低缩放倍数,或将过宽公式拆成较短的多行

幻灯片的具体设置可参考在 PowerPoint 中使用 LaTeX 公式。

6. 仍然无法解决时

先尝试示例库中的已知可用公式。如果能够正常渲染,就与自己的源码对照。如果刷新后连 x^2 也失败,请记录浏览器、操作系统、完整错误提示,以及能够复现问题的最短非保密公式,再联系支持。

公式渲染和图片导出在本地进行。最近公式保存在当前浏览器中,分享链接则会嵌入公式和设置。请不要在支持消息或分享链接中包含保密公式。

修正后,回到转换器继续导出。