latextools插件装不上，须先安装package control；编译失败多因构建系统未正确指定；pdf不同步需配置sumatra pdf反向搜索；中文乱码或宏包报错根源常在tex发行版未正确安装或path未配置。
LaTeXTools插件装不上？先确认Package Control是否就位
没装Package Control，LaTeXTools根本没法通过常规方式安装。它不是内置功能，必须靠这个包管理器拉取。别跳步——哪怕你刚重装完Sublime，也得先验证Package Control是否存在。
按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Install Package。如果命令面板里没出现这一项，说明Package Control压根没装好。此时不要去搜“LaTeXTools”，直接回退重装：打开控制台（Ctrl+`），粘贴官方安装命令（注意区分 Sublime Text 3/4 的 Python 3 语法），回车执行。成功后重启 Sublime，再试一次 Ctrl+Shift+P → Install Package。
安装LaTeXTools后编译失败？大概率是构建系统没选对
装完插件不等于能用。Sublime 默认不会自动把 .tex 文件绑定到 LaTeX 构建系统，第一次按 Ctrl+B 时，它往往弹出一个模糊的构建菜单，甚至默认走 Python 或空构建，结果当然是报错：error: No build system found 或直接卡住无输出。
- 手动指定：菜单栏
Tools → Build System → LaTeX – Basic Builder（Windows/MiKTeX）或LaTeX – Latexmk（推荐，支持增量编译） - 更稳的做法：在
.tex文件里第一行加注释声明引擎，比如%!TEX program = xelatex，这样插件能自动识别并匹配构建规则 - 避免陷阱：别点
Build With → New Build System…自己写 JSON——LaTeXTools自带的构建定义已覆盖常见场景，硬改反而容易破坏反向搜索、PDF 同步等依赖逻辑
编译能跑但PDF打不开或不同步？Sumatra PDF配置漏了关键一步
Windows 下最常卡在这儿：Ctrl+B 成功生成 PDF，但 Sumatra PDF 不弹窗，或双击 PDF 某行无法跳回 Sublime 对应位置。这不是插件问题，而是反向搜索（inverse search）没注册进 Sumatra。
必须在命令行中运行这句（路径按你实际安装位置替换）：
"C:\Program Files\SumatraPDF\SumatraPDF.exe" -inverse-search "\"C:\Program Files\Sublime Text 4\sublime_text.exe\" \"%f:%l\""
要点：
- 路径含空格必须用英文双引号包裹，且内部引号要转义（
\"） - Sublime 路径末尾不能带
.exe后缀，否则反向跳转失败 - 这条命令只需运行一次，注册进 Sumatra 的配置；之后每次启动 Sumatra 都自动生效
- Mac/Linux 用户不用这步，但需确保 PDF 查看器支持 SyncTeX，并在
LaTeXTools.sublime-settings中正确填写viewer路径
中文乱码、宏包报错？别急着改插件配置，先查底层TeX环境
LaTeXTools 只是调度器，真正干活的是你本地的 TeX 发行版（MiKTeX / TeX Live / MacTeX）。很多“插件配置失败”的表象，根源在发行版本身没装全或路径没暴露给系统。
终端里运行 pdflatex --version 和 xelatex --version，两个都得有响应。若报 command not found，说明发行版的 bin 目录没加进系统 PATH 环境变量——这时候改 LaTeXTools.sublime-settings 里的 texpath 是徒劳的，因为 Sublime 根本调不动底层命令。
验证方法：
- Windows：打开 CMD，输入
where pdflatex，应返回类似C:\Program Files\MiKTeX 2.9\miktex\bin\x64\pdflatex.exe - macOS/Linux：终端执行
which xelatex，应返回有效路径 - 若无输出，优先修复系统 PATH，而不是在 Sublime 配置里硬填绝对路径（硬填易失效，且跨机器不可移植）
反向搜索和 SyncTeX 支持这类细节，一旦底层 TeX 工具链不完整，插件再怎么配都只是表面功夫。
