MathJax 2 HTML-CSS分式字母大小不一的原因及解决办法

算力阿峰

2026-6-30

问题成因

MathJax 2的HTML-CSS/普通HTML渲染模式下，\frac默认属于行内textstyle环境，会对分子部分应用缩小的字体尺寸。此时\text命令处理文本时存在字体大小计算的兼容性bug：个别字符（如你遇到的首字母T）未正确继承统一的缩小后字体尺寸，导致与其他字母大小不一致。而SVG渲染模式基于矢量图形直接绘制，排版逻辑与HTML-CSS完全不同，因此不会出现这类样式计算错误。

可行解决办法

用\mbox替代\text：\mbox{TEST}会强制文本使用当前环境的正常字体尺寸，不受行内分数的缩小规则影响，既能保证字母大小一致，又不会像\dfrac那样整体放大公式。
自定义分数样式：使用\genfrac命令手动指定分子分母的字体大小，比如\genfrac{}{}{0pt}{1}{TEST}{2}，其中第四个参数1代表使用displaystyle（正常尺寸），既避免分子文本大小异常，又不会让整个公式过度放大。
调整MathJax配置：在MathJax配置中强制统一文本字体或关闭字体高度匹配，示例配置如下：
```
MathJax.Hub.Config({
  HTML-CSS: {
    matchFontHeight: false,
    textFont: "STIXGeneral"
  }
});
```
统一字体族可避免因字体 fallback 导致的尺寸差异，关闭字体高度匹配能减少样式计算冲突。
升级MathJax到3.x版本：MathJax 3重写了渲染引擎，彻底修复了大量2.x版本的排版bug，对Doxygen生成的HTML兼容性更好。需调整Doxygen配置文件中的MATHJAX_RELPATH指向MathJax 3的资源路径。
切换默认渲染模式为SVG：如果项目允许，在MathJax配置中设置默认使用SVG渲染，即可规避HTML-CSS模式的bug，但SVG模式在部分旧浏览器上兼容性稍差。