sublime text 编译 latex 失败的根本原因是底层工具链未正确配置：需验证 pdflatex 和 latexmk 是否在系统 path 中，手动设置 tex_path 路径，子文件首行添加 %!tex root 注释，并配置支持 synctex 的 pdf 预览器及可用的 subl 命令。
Sublime Text 本身不编译 LaTeX，装完插件却按 Ctrl+B 没反应、报 command not found: latexmk 或显示方块字，说明底层工具链没通——不是插件不会配，是 pdflatex 或 latexmk 根本不在系统 PATH 里，或者路径没对上。
验证 pdflatex 和 latexmk 是否真能被调用
这是最常跳过的一步，但直接决定后续所有配置是否有效。别信“我装了 MiKTeX/MacTeX 就行”，必须亲手敲命令确认：
- 打开终端（macOS/Linux）或命令提示符（Windows），运行：
pdflatex --version—— 必须返回版本号，否则 Sublime 编译必失败 - 再运行：
latexmk -v—— LaTeXTools 默认用它处理参考文献、多文件和自动重编译；若提示command not found，说明它没装或不在 PATH 中 - Windows 用户装 MiKTeX 后，安装向导里务必勾选「Add MiKTeX to the system PATH」；macOS 用 MacTeX，路径通常是
/Library/TeX/texbin，但需确认该路径已加入 shell 的$PATH（执行echo $PATH查看） - Linux 用户若用
apt install texlive-full，latexmk通常自带；但某些精简镜像（如 Docker 中的texlive-latex-recommended）不含它，得补装：sudo apt install latexmk
手动写死 tex_path，禁用自动探测
LaTeXTools 的 use_simple_detection 会扫描 PATH 却忽略你实际 bin 目录的位置，尤其在多 TeX 环境或自定义路径下极易失效。进 Preferences → Package Settings → LaTeXTools → Settings – User，粘贴完整配置，不要留空、不要依赖默认值：
- Windows（MiKTeX 2023）示例：
"tex_path": "C:\texlive\2023\bin\win32"（注意双反斜杠） - macOS（MacTeX）示例：
"tex_path": "/Library/TeX/texbin" - Linux（TeX Live）示例：
"tex_path": "/usr/local/texlive/2023/bin/x86_64-linux" -
tex_path必须精确到含可执行文件的目录（不是安装根目录），多个路径用冒号（macOS/Linux）或分号（Windows）分隔 - 删掉配置里任何
"use_simple_detection": true字段，它会覆盖你手动设的tex_path
子文件首行必须加 %!TEX root 注释
论文通常拆成 main.tex、introduction.tex、references.bib 等，但 Sublime 不知道哪个是主文件。不加注释，Ctrl+B 会只编译当前子文件，导致宏包未加载、参考文献不生成、交叉引用失效：
- 在每个子文件（如
introduction.tex）第一行写：%!TEX root = main.tex - 路径必须相对当前子文件位置正确；若
main.tex在上层目录，写成%!TEX root = ../main.tex - 这个注释只对
LaTeXTools生效，pdflatex命令行本身不识别它 - 保存后重新编译，否则注释不生效
PDF 预览器要支持 SyncTeX 且配准
很多人配完发现：PDF 生成了，但点不开；或点了 SyncTeX 没反应。这不是插件坏了，是 PDF 查看器没对上，或没开权限：
- Windows 强烈用
SumatraPDF：安装后，在设置中勾选「Allow inverse search」；LaTeXTools 配置里设"viewer": "sumatra" - macOS 必须用
Skim（不能用 Preview）：在 Skim → Preferences → Sync 中，设「PDF viewer」为 Sublime Text，「Command」填subl，「Arguments」填--wait --line {line} "{file}" - Linux 推荐
zathura+zathura-synctex插件；LaTeXTools 配置里设"viewer": "zathura"，否则Ctrl+Click反向搜索无效 -
subl命令必须可用：macOS/Linux 运行ln -s /Applications/Sublime Text.app/Contents/SharedSupport/bin/subl /usr/local/bin/subl；Windows 需把 Sublime 安装目录加进系统 PATH
最容易被忽略的是：subl 命令没装好，反向搜索就完全失效；还有子文件漏写 %!TEX root，编译出来的 PDF 里参考文献永远是问号。这些不是配置“不够高级”，而是基础链路断在了最底下一层。
