sublime text需配合latextools插件及本地tex发行版（如tex live）才能编译，终端运行pdflatex --version验证安装；配置时应禁用latexmk、指定lualatex引擎、设置输出目录及path路径。
Sublime Text 本身不内置 LaTeX 编译能力，必须通过插件（主要是 LaTeXTools）配合系统级 LaTeX 发行版（如 TeX Live 或 MiKTeX）才能完成编译。没装对底层工具链，插件再配置也没用。
确认本地已安装完整 LaTeX 发行版
这是最容易被跳过的一步——LaTeXTools 不带编译器，只负责调用命令。Windows 用户常只装了 MiKTeX，但没勾选“将 MiKTeX 添加到系统 PATH”；macOS 用户用 MacTeX 后未运行一次 sudo tlmgr update --self 初始化；Linux 用户用 apt install texlive-full 可能因磁盘空间跳过部分宏包，导致 amsmath、graphicx 等报错。
- 终端执行
pdflatex --version或lualatex --version能正常输出版本号才算通过 - 若提示 command not found，请先修复 PATH：Windows 检查环境变量，macOS 在
~/.zshrc中加export PATH="/usr/local/texlive/2023/bin/universal-darwin:$PATH"（路径按实际年份调整） - 不要试图用在线编译器（如 Overleaf）替代本地安装——
LaTeXTools无法连接远程服务
安装并配置 LaTeXTools 插件
Package Control 是前提。如果没装，先用 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Install Package Control 安装它。
- 再按一次
Ctrl+Shift+P，输入Package Control: Install Package，搜索并安装LaTeXTools - 安装后重启 Sublime Text，新建一个
test.tex文件，保存为 UTF-8 编码，第一行写\documentclass{article}，此时状态栏应显示LaTeX语法高亮 - 若仍显示
Plain Text，手动点击右下角 →Set Syntax→LaTeX
设置编译引擎与快捷键
LaTeXTools 默认用 latexmk，但它在 Windows 上需额外安装 Perl，容易失败。更稳的方案是显式指定引擎，并绑定快捷键。
- 进入
Preferences → Package Settings → LaTeXTools → Settings – User - 粘贴以下最小化配置（覆盖默认 settings）：
{
"builder": "traditional",
"display_log": true,
"view_on_build": true,
"command": ["lualatex", "-shell-escape", "-synctex=1", "-interaction=nonstopmode", "-file-line-error"],
"output_directory": "_build",
"texpath": "/usr/local/texlive/2023/bin/universal-darwin:$PATH"
}
说明：
– "builder": "traditional" 关闭 latexmk，直接调用 lualatex（兼容中文和 Unicode 更好）
– -shell-escape 是调用 minted 或外部图生成工具（如 pgfplots）的必要参数
– "output_directory": "_build" 把中间文件（.aux, .log 等）统一隔离，避免污染源目录
– texpath 仅 macOS/Linux 需要，Windows 用户删掉该行，改用系统 PATH
- 编译快捷键默认是
Ctrl+B（Win/Linux）或Cmd+B（macOS），无需额外绑定 - 若想一键清理辅助文件，可安装
LaTeXing或手动建 Build System：菜单Tools → Build System → New Build System，填入rm _build/*（macOS/Linux）或del /s /q _build\*（Windows）
处理常见报错与数学符号问题
写数学论文时最常卡在三类错误：字体缺失、宏包未加载、Synctex 跳转失效。
-
Font \TU/lmr/m/n/10=[lmroman10-regular]:+tlig; at 10.0pt not loadable：说明当前引擎不支持 TU 编码（Unicode）。解决方法是把\usepackage[utf8]{inputenc}删掉（仅适用于旧文档），新文档一律用lualatex+\usepackage{fontspec}，并确保主字体存在（如 macOS 用\setmainfont{Helvetica}，Windows 用\setmainfont{SimSun}） - 公式编号不显示？检查是否漏了
\usepackage{amsmath}，且环境用\begin{equation}而非$$...$$（后者在 LaTeXTools 中可能被截断） - Synctex 正向/反向跳转失效？确认 PDF 查看器支持：macOS 用 Skim（需在 Skim → Preferences → Sync 设置为 “Sublime Text”），Windows 推荐 SumatraPDF（Sublime 中设置
"viewer": "sumatrapdf"）
真正麻烦的是跨平台路径和编码混用：比如在 Windows 写好路径含中文的 \includegraphics{图1.png}，同步到 macOS 就报错——不是插件问题，是文件系统对 Unicode 处理差异。这类细节，比配置本身更耗时间。
