latextools 是目前唯一稳定支持 sublime text 4 的 latex 插件，因 latexing 已于 2021 年停更，不兼容新版本且缺失 synctex、biber 等关键功能；latextools 持续更新，原生支持 xelatex/lualatex、多文件编译、正反向同步及自动清理，构建逻辑基于系统命令调用，契合真实论文工作流。
LaTeXTools 是目前唯一能稳定用于科研论文写作的 Sublime 插件，LaTeXing 已停更且在 Sublime Text 4 上直接报错。其他所谓“LaTeX 插件”要么功能残缺（如只高亮不编译），要么依赖过时 API，无法处理 biber、\include、TikZ 或多文件主文档等真实论文场景。
为什么 LaTeXTools 是唯一可行选择
LaTeXing 在 2021 年停止维护，Sublime Text 4 启动时会抛出 ImportError: No module named 'sublime_plugin'；它也不支持 synctex=1 参数下的反向搜索，参考文献常漏生成。LaTeXTools（GitHub 仓库 rst67/LaTeXTools）持续更新，明确支持 XeLaTeX/LuaLaTeX、biber、自动清理临时文件、多级 \includeonly 和正反向同步。它的构建逻辑是调用系统命令，不是封装简易编译器——这点决定了它能跟上真实论文工作流。
中文论文必须用 XeLaTeX 或 LuaLaTeX，不能硬套 pdflatex + ctex
常见报错 Package ctex Error: No available font found. 不是缺宏包，而是 pdflatex 无法加载系统字体，ctex 找不到可用中文字体链。解决方案只有两个：
- 改用
xelatex：导言区第一行加\usepackage{ctex}（必须放最前），无需额外设字体 - 改用
lualatex：导言区加\usepackage{fontspec}和\setmainfont{Noto Serif CJK SC}等具体字体名 - 在 LaTeXTools 用户配置中强制指定编译器：
"cmd": ["latexmk", "-pdfxe", "-synctex=1", "$file"]（-pdfxe即走 XeLaTeX）
PDF 同步失败？90% 是 viewer 绑定或 synctex 文件位置不对
点 PDF 某处没跳回源码，或跳到错误行，不是插件问题，而是以下任一条件未满足：
-
synctex=1参数必须出现在最终执行的命令里（LaTeXTools 默认已加，但若自定义builder容易漏） -
.pdf和.synctex.gz必须在同一目录、同名；若主文档叫main.tex，就别把输出设成output/main.pdf - macOS 必须用 Skim，且 Skim → Preferences → Sync 中勾选
Enable SyncTeX，并设 PDF viewer 为 Sublime - Windows 必须用 SumatraPDF，且在 Sumatra → Settings → Options 底部填：
"C:\Program Files\Sublime Text 4\sublime_text.exe" "%f:%l" - Linux 若用 evince，需确认 D-Bus 已启用，且配置中
"viewer": "evince"后加"forward_search_on_start": true
装完 MacTeX / TeX Live 后 Sublime 还是找不到 latexmk？重启和 PATH 都得做
终端里 latexmk --version 能运行，但 Sublime 编译报 command not found，说明 Sublime 没读到你的 PATH。这不是插件 bug，是启动方式导致的环境隔离：
- Mac 用户：不要只改
~/.zshrc，还要确保 Sublime 是从终端用open -a "Sublime Text"启动，或重装时勾选 “Install shell commands” - Windows 用户：安装 TeX Live 时务必勾选
Install latexmk，否则latexmk不在 bin 目录下 - Linux 用户：确认
sudo apt install latexmk已执行，且/usr/bin/latexmk存在 - 验证方式：Sublime 控制台（
Ctrl+`）输import os; print(os.environ.get('PATH'))，检查输出是否含texlive或MacTeX路径
真正卡住人的从来不是“怎么配”，而是 latexmk 没装、synctex.gz 被生成到子目录、或者 PDF 查看器根本没启用 SyncTeX 支持——这些地方一错，整个流程就静默失效，连错误提示都不给。
