latextools 是 sublime text 唯一值得装、也必须装的 latex 编译插件，因其长期维护、支持正反向同步、多引擎切换及自动宏包下载，而其他插件如 latexing 已废弃或功能残缺；90% 编译失败源于未安装或配置错误，需手动执行 reconfigure 和迁移设置，并确保 distro、texpath、sumatra 路径真实有效。
直接说结论：LaTeXTools 是 Sublime Text 唯一值得装、也必须装的 LaTeX 编译包，其他插件基本没用或已废弃。
为什么只装 LaTeXTools？
Sublime Text 本身不带任何 LaTeX 编译能力，LaTeXTools 是唯一长期维护、支持正反向同步、自动宏包下载、多引擎切换（pdflatex/xelatex/lualatex）的成熟插件。你搜到的 LaTeXing、LaTeXTools-Alt 等要么已停止更新，要么编译逻辑残缺，容易卡在 ! Undefined control sequence 或根本打不开 PDF。
常见错误现象：Ctrl+B 后无反应、弹出“Build system not found”、PDF 打开但双击跳转失败、中文显示为方块——这些问题 90% 都源于没装 LaTeXTools，或装了但没配对发行版。
- 它不依赖 Sublime 的 Build System 框架，而是自己封装调用
latexmk或pdflatex等命令 - 支持 Windows/macOS/Linux 三平台，配置项清晰（
distro、texpath、sumatra等字段直指关键路径） - 反向搜索（SumatraPDF → Sublime）和正向跳转（Sublime → PDF）都靠它驱动，不是靠“Viewer 设置”单独搞定
安装后必须立刻做的三件事
装完 LaTeXTools 不等于能用。它默认不生效，必须手动触发初始化和路径绑定：
- 按
Ctrl+Shift+P，输入LaTeXTools: Reconfigure and migrate settings并回车（不是“Reset”，那是清空配置） - 重启 Sublime Text，否则新配置不加载
- 打开
Preferences → Package Settings → LaTeXTools → Settings – User，确认以下三项已填且路径真实存在：
—"distro": "miktex"（Windows）或"distro": "texlive"（macOS/Linux）
—"texpath"指向你的bin目录，例如 Windows 是"C:\Program Files\MiKTeX 2.9\miktex\bin\x64;$PATH"
—"sumatra"（仅 Windows）填完整路径，如"C:\Program Files\SumatraPDF\SumatraPDF.exe"
漏掉任意一项，Ctrl+B 就会静默失败，控制台里看不到报错，只在右下角闪一下“Building…”就消失。
Windows 下 SumatraPDF 反向搜索失效怎么办
这是最常卡住的环节：PDF 双击不跳回 Sublime，或者跳过去但行号错位。根本原因不是 Sublime 配置错，而是 SumatraPDF 没被正确告知编辑器路径。
必须在命令行（cmd）中执行这句（路径要严格匹配你本地安装位置）：
SumatraPDF.exe -inverse-search ""C:Program FilesSublime Text 3sublime_text.exe" "%f:%l""
注意：
— 引号嵌套不能少，" 是转义，Windows 下必须这样写
— %f:%l 中的冒号是固定格式，不是英文句点或中文顿号
— 这条命令只需运行一次，SumatraPDF 会把它存进注册表，之后每次启动都生效
— 如果用的是便携版 SumatraPDF（比如放在 D: ools），那路径就得写成 D: oolsSumatraPDF.exe，不能只写可执行文件名
中文编译失败时优先检查这三点
用 ctex 或 xeCJK 写中文却编译出乱码或报 Font T1/cmr/m/n/10=ecrm1000 at 10.0pt not loadable，通常不是字体问题，而是引擎和编码没对齐：
- 确保
.tex文件保存为 UTF-8 编码（Sublime 底部状态栏看 Encoding） - 文件第一行加声明：
%!TEX program = xelatex（不是pdflatex） - 在
LaTeXTools.sublime-settings中确认"builder": "simple"，并把"default_compiler"设为"xelatex"；如果用latexmk，还要额外设"latexmk_options"加-xelatex
Mac 用户额外注意：xelatex 依赖系统字体，若用非 Apple 字体（如 Noto Sans CJK），需在导言区显式声明：setmainfont{Noto Sans CJK SC}，否则编译会卡在字体加载阶段。
真正麻烦的从来不是装哪个包，而是每一步路径是否真实存在、每个引号是否转义正确、每个引擎是否匹配文档声明——这些细节错一个，整个流程就断在无声处。
