必须先安装TeX Live等LaTeX发行版，再通过Package Control安装LaTeXTools插件并配置builder路径与主文件识别规则，最后用日志面板排查编译问题。
安装 LaTeX 发行版是前提，不是 Sublime 的事
Sublime Text 本身不提供 LaTeX 编译能力，它只是个编辑器。你必须先在系统里装好 TeX Live（Windows 推荐 TeX Live，macOS 推荐 MacTeX，Linux 一般用 texlive-full 包）。装完后终端输入 pdflatex --version 或 lualatex --version 能返回版本号，才算就位。
常见错误现象：command not found: pdflatex 或插件报错 Could not find a suitable LaTeX command——基本都是因为没装发行版，或 PATH 没配对。macOS 如果用 Homebrew 安装的 MacTeX，可能需要手动把 /Library/TeX/texbin 加进 shell 的 PATH；Windows 用户注意安装时勾选「Add TeX Live to PATH」。
用 Package Control 安装 LaTeXTools 插件
LaTeXTools 是 Sublime 下最成熟、维护活跃的 LaTeX 支持插件，支持编译、反向搜索、结构导航、引用补全等。别用老掉牙的 LaTeXing（已停止更新）或零散脚本。
操作步骤：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），调出命令面板 - 输入
Package Control: Install Package，回车 - 再输入
LaTeXTools，回车安装 - 安装完重启 Sublime（必须）
安装后默认会尝试自动检测 pdflatex 路径。如果检测失败，后续需手动配置 builder_path。
配置 builder 和主文件识别规则
LaTeXTools 默认用 traditional builder（即调用 latexmk），但很多用户没装 latexmk，导致编译失败。建议显式指定编译器，并启用自动主文件识别。
打开 Sublime 的 Preferences > Package Settings > LaTeXTools > Settings，在右侧用户设置中填入：
{
"builder": "traditional",
"builder_settings": {
"cmd": ["lualatex", "-shell-escape", "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%E"]
},
"auto_insert_root": true,
"root_file_regex": "^\\documentclass|\\begin\{document\}"
}
说明：
-
"cmd"里用lualatex而非pdflatex：现代中文论文更稳定，避免 CJK 字体乱码；-shell-escape是运行minted或外部图生成工具（如pgfplots）必需的 -
"auto_insert_root": true表示当你在子文件（如ch1.tex）里按Ctrl+B编译时，插件会自动向上查找含documentclass的主文件（如main.tex）来编译 - 若项目用
input{}或include{}拆分，确保主文件第一行附近有documentclass，否则正则匹配失败
编译失败时查日志和临时文件位置
编译出错不显示红字？不是插件坏了，而是默认把输出重定向到 Sublime 底部状态栏或隐藏日志。按 Ctrl+Shift+P 输入 LaTeXTools: Toggle log panel 就能呼出完整编译日志。
关键路径要记住：
- 所有
.aux、.log、.out、.synctex.gz都生成在源文件同目录下 - PDF 默认也输出到同一目录，除非你改了
output_directory设置（不建议初学者动） - 如果 PDF 打不开，检查是否被系统 PDF 阅读器独占锁住（尤其是 Windows 的 Adobe Reader）；推荐用
Skim（macOS）或SumatraPDF（Windows）配合反向搜索
一个容易被忽略的点：Sublime 不监控文件变化自动刷新 PDF。你得手动切换到 PDF 查看器并按快捷键（如 SumatraPDF 的 Ctrl+R）重载，或者开启其「监视文件」选项。
