latextools装不上是因为package control未安装成功；需先按ctrl+`调出控制台，粘贴对应sublime text 3或4的官方安装命令，重启后按ctrl+shift+p验证“install package”是否出现，再安装latextools。
LaTeXTools 装不上？先卡在 Package Control 这一步
不是插件有问题，是 Sublime 根本没拿到“安装能力”。Package Control 没装好，LaTeXTools 就永远进不了插件列表。
按 Ctrl+`（反引号）调出控制台，粘贴官方安装命令——注意区分 Sublime Text 3 和 4 的 Python 版本差异。Windows 上如果用 QQ 输入法，这个快捷键常被拦截，得先关掉热键切换。
- 装完必须重启 Sublime：它只在启动时读一次插件路径，不重启等于白装
- 重启后按
Ctrl+Shift+P，搜Install Package——能出来才说明Package Control活了 - 别跳过验证：Preferences → Package Settings 里能看到
Package Control项，才是真成功
装完 LaTeXTools 却 Ctrl+B 报错？构建系统没绑对
LaTeXTools 自带多套构建规则，但 Sublime 不会自动把 .tex 文件和它们关联。第一次按 Ctrl+B，大概率走空构建或 Python 构建，报 No build system found 或直接没反应。
- 手动选：菜单 Tools → Build System →
LaTeX – Latexmk（推荐，支持增量编译）或LaTeX – Basic Builder（Windows + MiKTeX） - 更稳的写法：在
.tex文件第一行加注释，比如%!TEX program = xelatex，插件会据此自动匹配构建链 - 别自己新建 JSON 构建系统——
LaTeXTools内置的已含 SyncTeX、反向搜索等关键逻辑，硬改容易断掉 PDF 跳转
公式空白、中文乱码？不是字体问题，是工具链断在底层
90% 的“公式不显示”或“中文变方块”，根本不是 ctex 宏包没装或字体路径错，而是 latexmk 或 xelatex 命令压根没跑起来。
- 终端里执行
latexmk -v和xelatex --version——两个都得吐出版本号；任一报command not found，说明 TeX 工具链不在$PATH - Windows 装 MiKTeX 时，务必勾选「Add MiKTeX to the system PATH」；macOS 装 MacTeX 后，确认
/Library/TeX/texbin已写入~/.zshrc并执行了source ~/.zshrc - Linux 用户注意：
sudo apt install texlive-latex-recommended不含latexmk，得额外运行sudo apt install latexmk
PDF 打不开或双击不跳回代码？Sumatra PDF 反向搜索注册漏了
Windows 下最常见：Ctrl+B 编译成功，PDF 生成了，但 Sumatra PDF 不弹窗，或双击 PDF 行号跳不到 Sublime 对应位置。这不是插件配置问题，是反向搜索没注册进 Sumatra。
- 必须在命令行运行这句（路径按你实际安装位置替换）：
"C:\Program Files\SumatraPDF\SumatraPDF.exe" -inverse-search "\"C:\Program Files\Sublime Text 4\sublime_text.exe\" \"%f:%l\"" - 要点：Sublime 路径末尾不能带
.exe；路径含空格必须用英文双引号包裹，且内部引号要转义为\" - 这条命令只需运行一次，注册进 Sumatra 的全局设置，之后所有 PDF 都生效
真正麻烦的从来不是装几个插件，而是环境变量、命令路径、反向搜索注册这些“看不见”的连接点——断一处，整个流程就卡死。动手前先终端验证命令，比瞎调配置快十倍。
