Sublime Text 需通过 LaTeXTools 插件调用本地 LaTeX 发行版(如 TeX Live 或 MiKTeX)编译,前提为发行版已正确安装并加入系统 PATH,且 texpath 等配置准确;否则 Ctrl+B 无响应或报 command not found。
Sublime Text 本身不内置 LaTeX 编译能力,必须通过插件(主要是 LaTeXTools)配合本地已安装的 LaTeX 发行版(如 TeX Live 或 MiKTeX)才能完成编译。没装对发行版、路径没配准、构建系统没选对,三者任一出错都会导致 Ctrl+B 按下后“没反应”或报 command not found。
确认本地 LaTeX 发行版已正确安装并可命令行调用
这是最常被跳过的前置步骤。LaTeXTools 不会帮你装 TeX,它只调用你系统 PATH 里的 latexmk、pdflatex 等命令。
- 打开终端(macOS/Linux)或命令提示符(Windows),运行
latexmk --version;若提示“未找到命令”,说明发行版未安装,或安装时没勾选“添加到系统 PATH” - Windows 用户尤其注意:MiKTeX 默认不把 bin 加入 PATH,需手动将类似
C:\Program Files\MiKTeX\miktex\bin\x64\的路径加入系统环境变量 - macOS 用户用 Homebrew 安装 TeX Live 后,通常需运行
sudo tlmgr path add才能全局可用 - 验证成功后,Sublime 才可能在构建时找到编译器
安装 LaTeXTools 插件并配置主构建系统
LaTeXTools 是 Sublime 上最成熟、更新活跃的 LaTeX 插件,但它的默认配置依赖用户本地环境,不能开箱即用。
- 用 Package Control 安装
LaTeXTools后,务必重启 Sublime(否则插件不加载) - 打开
Preferences → Package Settings → LaTeXTools → Settings – User,粘贴以下最小配置(重点是builder_path和texpath):
{
"builder": "latexmk",
"builder_path": "",
"texpath": "/usr/texbin:/usr/local/bin:/opt/homebrew/bin:/usr/bin"
}
其中 texpath 要根据你实际的 LaTeX 命令所在路径调整(用 which latexmk 查);Windows 用户应改为类似 "texpath": "C:\Program Files\MiKTeX\miktex\bin\x64\"