VS Code下Jupyter Notebook扩展LaTeX公式渲染方法与异常排查

结合你当前使用的VS Code 1.52、对应版本Jupyter与Python扩展的已知特性，可按照以下方向逐点排查，相关特征完全匹配你提到的“网上复制的公式可正常渲染、自写公式样式异常”的现象：

• 检查自写公式的LaTeX包裹语法合规性
  这个版本的Jupyter扩展没有做宽松语法兼容，对公式包裹符号的识别阈值非常严格：行内公式必须用前后紧贴的$包裹内容，块级公式必须用前后紧贴的$$包裹内容；如果在$和公式内容之间加了半角/全角空格、漏写了单侧的包裹符号、把$写在反斜杠后面转义，扩展就识别不到这是LaTeX公式，会直接输出为等宽字体的纯文本。从网上复制的公式一般是经过格式校验的标准写法，所以能正常触发渲染逻辑。
• 检查Sympy输出内容的格式匹配度
  老版本扩展对Sympy表达式的自动渲染适配存在兼容bug：如果没有提前开启Sympy的LaTeX打印配置，Sympy输出的内容本质是Python转义后的纯文本字符串，不是扩展能识别的LaTeX语法格式；网上复制的静态公式是原生的LaTeX语法字符串，不受这个兼容bug影响，因此可以正常渲染。
• 检查内置渲染引擎的加载状态
  你当前使用的Jupyter扩展是离线内置KaTeX渲染引擎的版本，如果工作区权限不足、或者扩展自动检测渲染模式时出现误判，会对基础语法公式正常渲染、对带自定义嵌套结构的自写公式触发渲染回退，出现样式不符合LaTeX标准的问题。

• 严格适配老版本扩展的语法规则写公式
  • 行内公式：$符号和紧跟的公式内容之间不要留空格，例如正确写法为$\frac{a}{b} + c$，错误写法为$ \frac{a}{b} + c $
  • 块级公式：$$符号单独占一行，前后不要紧贴其他正文内容，例如正确写法为单独换行书写$$\sum_{i=1}^n i = \frac{n(n+1)}{2}$
• 提前配置Sympy的输出规则
  在Notebook的首个代码单元格中执行固定初始化配置，让Sympy自动输出符合识别要求的LaTeX格式内容：

  from sympy import init_printing
  init_printing(use_latex=True, latex_mode='equation')
  

• 强制指定渲染引擎避免自动检测误判
  打开VS Code设置，搜索jupyter.mathRenderer配置项，将默认的auto模式修改为katex，强制使用扩展内置的KaTeX引擎渲染所有公式，最后重启VS Code让配置生效。

内容的提问来源于stack exchange，提问作者mumu