Sublime Text 通过 LaTeXTools 插件可搭建支持 PDF 实时预览的 LaTeX 环境,需配合 MiKTeX/TeX Live、SumatraPDF(Win)或 Skim(macOS)等外部工具,配置 texpath 和 viewer 路径后按 Ctrl+B/Cmd+B 编译并自动刷新 PDF。

Sublime Text 本身不内置 LaTeX 编译功能,但通过 LaTeXTools 插件可快速搭建支持 PDF 实时预览(反向搜索、正向搜索、自动编译)的 LaTeX 环境。关键不是“实时编译”(Sublime 不像 VS Code + LaTeX Workshop 那样原生支持热重载),而是配置好后按快捷键(如 Ctrl+B / Cmd+B)一键编译并自动调用 PDF 查看器刷新——配合 SumatraPDF(Windows)或 Skim(macOS)即可接近“实时”体验。
安装 LaTeX 发行版和 PDF 查看器
这是前提,LaTeXTools 只是调度器,真正干活的是外部工具:
- Windows:安装 MiKTeX(推荐)或 TeX Live;安装 SumatraPDF(必须!它支持反向搜索且能被 LaTeXTools 自动监听文件变更)
- macOS:安装 MacTeX;安装 Skim(需在 Skim → Preferences → Sync 中勾选 “Check for file changes” 并设为默认 PDF 查看器)
-
Linux:安装
texlive-full(Ubuntu/Debian)或对应发行版的完整 TeX 套件;推荐使用evince或okular,但反向搜索支持较弱,更推荐配置zathura+synctex
安装并配置 LaTeXTools 插件
在 Sublime Text 中通过 Package Control 安装:
- 按下
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Install Package,回车 - 搜索
LaTeXTools,选择安装 - 安装完成后,进入
Preferences → Package Settings → LaTeXTools → Settings – User - 根据系统填入关键路径(其他保持默认即可):
Windows 示例(MiKTeX + SumatraPDF):"texpath": "C:\\Program Files\\MiKTeX 2.9\\miktex\\bin\\x64\\","viewer": "sumatra","sumatra_path": "C:\\Program Files\\SumatraPDF\\SumatraPDF.exe"
macOS 示例(MacTeX + Skim):"viewer": "skim","skim_path": "/Applications/Skim.app"
启用自动编译与 PDF 刷新
LaTeXTools 默认不自动刷新 PDF,需手动触发或设置保存即编译:
- 编译主文档:确保当前打开的是
.tex文件,且文件内含% !TEX root = main.tex(若用子文件),然后按Ctrl+B(Win/Linux)或Cmd+B(macOS) - 启用“保存即编译”:在
Settings – User中添加:"builder": "script","save_before_build": true,"auto_build": true - PDF 刷新依赖查看器:SumatraPDF 和 Skim 在检测到 PDF 更新后会自动重载(无需额外插件),前提是它们由 LaTeXTools 启动(即首次用
Ctrl+B编译后打开)
调试常见问题
编译失败或 PDF 不刷新?优先检查这几点:
- 终端执行
pdflatex --version能否返回版本号?不能说明 TeX 环境未加入系统 PATH,需在 LaTeXTools 设置中显式指定texpath - PDF 没有自动刷新?确认你用的是 SumatraPDF(Win)或 Skim(macOS),且 PDF 是由 LaTeXTools 第一次编译打开的(不是双击手动打开)
- 反向搜索(PDF 点击跳转到源码)失效?检查 SumatraPDF 的设置:Settings → Options → “Inverse search command line” 应为:
"C:\Program Files\Sublime Text\subl.exe" "%f:%l"(路径按实际调整) - 中文编译乱码?在导言区改用
ctex宏包或xeCJK,并确保编译器设为xelatex(在 LaTeXTools 设置中改"builder_settings": {"target": "xelatex"})
基本上就这些。配置一次,后续新建 .tex 文件按 Ctrl+B 就能出 PDF,配合反向搜索效率很高。不需要复杂服务器或后台进程,轻量又稳定。










