Sublime Text本身不渲染LaTeX公式，仅调用系统工具链：PDF编译靠latexmk/xelatex，Markdown实时预览靠MathJax；90%公式空白问题源于命令未通，须终端验证版本、写死tex_path、禁用自动探测、子文件首行声明%!TEX root = main.tex，并从终端启动Sublime确保PATH生效。
Sublime Text 本身不渲染 LaTeX 数学公式——它连公式解析器都没有。所谓“公式渲染”，实际分两种完全不同的路径：一种是编译整个 .tex 文件生成 PDF（靠 latexmk/xelatex），另一种是在 Markdown 或纯文本里实时预览行内/块级公式（靠 MathJax）。两者技术栈、配置方式、依赖工具全都不一样，混着配只会失败。
LaTeXTools 编译 PDF：公式显示为空白？先看命令是否真能跑通
90% 的“公式不显示”问题，根源是 latexmk 或 xelatex 根本没被 Sublime 调起来。插件只是个壳，底层命令失败时往往只报“build failed”，不告诉你缺什么。
- 必须在终端（macOS/Linux）或 PowerShell（Windows）里手动执行：
latexmk -v和xelatex --version—— 两者都得输出版本号；任一报command not found，说明 TeX 工具链没装好或不在$PATH - Windows 用户重装 MiKTeX 时，务必勾选「Add MiKTeX to the system PATH」；macOS 用 MacTeX 后，确认
/Library/TeX/texbin已写入~/.zshrc并执行了source ~/.zshrc - Linux 用户常见坑：
sudo apt install texlive-latex-recommended不含latexmk，得额外运行：sudo apt install latexmk - 装完必须重启 Sublime Text——它启动时读一次
PATH，改完环境变量不重启等于没改
Markdown 里写公式：用 OmniMarkupPreviewer + MathJax
如果你只是想在 .md 文件里写 $E=mc^2$ 然后实时看到渲染效果，别碰 LaTeXTools。它不处理 Markdown，也不调 MathJax。
- 装插件：
Ctrl+Shift+P→Package Control: Install Package→ 搜OmniMarkupPreviewer安装 - 启用 MathJax：打开
Preferences → Package Settings → OmniMarkupPreviewer → Settings – User，加一行："mathjax_enabled": true - 网速慢导致 MathJax 加载超时？手动下载
mathjax.zip，解压到：Packages/OmniMarkupPreviewer/public/，再在该目录下建空文件MATHJAX.DOWNLOADED - 预览快捷键默认是
Ctrl+Alt+O（Windows/Linux）或Cmd+Alt+O（macOS），不是Ctrl+B—— 后者是 LaTeXTools 的编译快捷键，混用会触发错误构建
中文公式和字体问题：ctex + xelatex 是硬要求
在 .tex 文件里写中文公式却显示方块？不是字体没装，是引擎和文档类根本没对上。
-
\documentclass[UTF8]{ctexart}或\documentclass[UTF8]{ctexrep}必须出现在第一行（且不能有空行） - 构建器必须设为
latexmk，且builder_settings里明确指定：-pdfxe（启用 xelatex）和-synctex=1（支持跳转） - 子文件（如
ch1.tex）顶部第一行必须写：%!TEX root = main.tex—— 否则latexmk不知道从哪开始 include，中文宏包根本加载不上 - 不要用
pdflatex构建含中文的文档；lualatex可行但需额外配置fontspec，xelatex + ctex 是最稳路径
真正容易被忽略的点：Sublime 启动方式。如果你双击图标打开 Sublime，它继承的是图形界面的 PATH，往往不含 TeX 工具；必须从终端运行 subl（macOS/Linux）或 subl.exe（Windows），才能确保环境变量生效。这点不验证，所有配置都是空中楼阁。
