mp-html的latex插件需手动启用：下载github全量源码，放开config.js中'latex'注释，执行npm run build:uni-app，复制dist/uni-app组件并全局引入katex.min.css，公式仅支持$...$和$$...$$语法，异步内容需nexttick后调用reload。
mp-html 的 latex 插件必须手动启用，npm install 不生效
uni-app 小程序端无法直接用 MathJax，因为微信小程序不支持动态执行 script 标签、禁止 eval 和 DOM 操作。mp-html 是目前最稳定的选择，但它默认不带 latex 渲染能力——npm install mp-html 安装的只是精简版，latex 插件被注释掉了。
正确做法是：
- 去 GitHub 下载 mp-html 全量源码（不是 npm 包）
- 打开 tools/config.js，把 'latex' 从注释中放开
- 运行 npm run build:uni-app
- 把生成的 dist/uni-app/components/mp-html 复制进项目目录
- 在页面 json 中声明："usingComponents": { "mp-html": "/components/mp-html/mp-html" }
漏掉任一环节，比如只改了 config.js 但没重新 build，或者复制了旧版组件，公式都会显示为原始 LaTeX 字符串（如 $x^2$ 而非渲染结果）。
公式写法必须严格匹配 mp-html 的 latex 插件规则
mp-html 的 latex 插件只识别两种包裹方式：$...$（行内）和 $$...$$（块级），不支持 ( ... ) 或 [ ... ]。DeepSeek 等模型返回的公式若混用语法，会直接跳过渲染。
实操建议：
- 接口返回后，先用正则统一转换：content.replace(/\((.*?)\)/g, '$$1$').replace(/\[(.*?)\]/g, '$$1$$')
- 避免在公式内使用未转义的 $ 符号，否则会提前截断（例如 $a $ b$ 只渲染出 a ）
- 块级公式前后不能紧贴文字，需换行或加空格，否则解析器可能误判为行内公式
katex 样式必须显式引入，否则公式无字体、错位、字号异常
mp-html 的 latex 插件依赖 katex 渲染，但不会自动注入 katex 的 CSS。没有样式时，公式会以纯文本形式堆叠，或只显示方框占位符。
解决方案：
- 在页面 <style></style> 中引入 katex 官方 CDN 样式：@import url('https://cdn.jsdelivr.net/npm/katex@0.16.9/dist/katex.min.css');
- 或者下载 katex.min.css 放入项目 static 目录，再用 @import '@/static/katex.min.css';
- 注意：uni-app 的 scoped style 对 <mp-html></mp-html> 内部无效，样式必须写在全局或页面级 style 中
复杂公式性能差、首屏卡顿，得控制渲染时机
含多行积分、矩阵、分式嵌套的公式（比如 $$int_0^infty e^{-x^2}dx = rac{sqrt{pi}}{2}$$）在小程序里渲染耗时明显，尤其低端安卓机上容易卡住整个页面滚动。
缓解方法：
- 不要在 v-for 列表中直接渲染大量公式，改用懒加载：只有滚动到可视区域才触发 mp-html 的 render 方法
- 公式内容变化时，避免频繁调用 setData，可用 ref + this.$refs['mpHtml'].reload() 局部刷新
- 对超长公式（> 3 行），考虑降级为图片：服务端用 mathjax-node 或 katex-cli 渲染成 PNG，前端 fallback 显示
最易被忽略的一点：mp-html 默认会在组件 mounted 后自动渲染，但如果公式内容是异步加载（比如 API 返回后赋值），必须确保赋值完成后再等框架触发渲染——否则拿到的是空内容。建议在 nextTick 里手动调用 reload。
