推荐使用“latex workshop”插件，它支持完整编译链、正向/反向搜索、大纲导航和实时pdf同步；需确保工作区含.tex文件且正确配置latexmk或pdflatex编译链，搭配xelatex与utf-8编码处理中文，并选用skim或sumatrapdf实现pdf热重载。
LaTeX插件装哪个才真正能用
VSCode里叫“LaTeX Workshop”的插件是唯一推荐选择，其他如“LaTeX”或“LaTeX Tools”已长期不更新，LaTeX Workshop 支持完整编译链、正向/反向搜索、大纲导航和实时PDF同步。安装后不用重启，但需确认状态栏右下角出现 LaTeX 图标，否则说明没激活——常见原因是工作区根目录下缺少 tex 文件或未打开含 .tex 的文件夹。
编译命令配错就根本出不了PDF
LaTeX Workshop 默认用 latexmk，但很多新手本地没装它，直接点“Build LaTeX project”会报错：Command "latexmk" not found。解决路径很明确：
- macOS：用
brew install latexmk（别只装basic-tex，它不含latexmk） - Windows：推荐安装
TeX Live全量版，勾选latexmk组件；MinTeX 不带latexmk，硬配pdflatex会丢参考文献和交叉引用 - Linux：确保
latexmk在$PATH中，运行which latexmk能返回路径才算生效
如果坚持不用 latexmk，可在 settings.json 里手动设 latex-workshop.latex.recipe.default 为 lastUsed，再定义 recipe 调用 pdflatex → bibtex → pdflatex ×2，但容易漏步、难调试。
PDF预览不自动刷新？八成是反向搜索配置惹的祸
默认开启的 synctex 反向搜索（Ctrl+Click PDF跳回源码）会锁住 PDF 文件，导致修改 .tex 后 PDF 不自动重载。这不是 bug，是 Adobe Reader 或某些 PDF 查看器的行为限制。实操建议：
- 换用
Skim（macOS）或SumatraPDF（Windows），它们支持文件系统级热重载，且与LaTeX Workshop深度集成 - 在 VSCode 设置中关闭
latex-workshop.view.pdf.viewer的tab模式，改用external，并填对查看器路径，例如 Windows 下设"latex-workshop.view.pdf.external.viewer.command": "C:\Program Files\SumatraPDF\SumatraPDF.exe" - 别碰
latex-workshop.view.pdf.internal.synctex.afterBuild.enabled这个开关——关了它虽能强制刷新，但会彻底失去点击跳转能力
中文论文编译失败？编码和引擎必须对齐
用 ctex 类写中文论文时，UTF-8 编码 + xelatex 是唯一稳妥组合。常见错误包括：
- 保存
.tex文件时用了GBK编码，编译报Package inputenc Error: Unicode char … - 误选
pdflatex引擎，结果中文全变方框，日志里反复出现Font zf@basefont=... not loadable -
ctex宏包版本太老（如 2.4.x），不兼容新版xeCJK，表现为标题字号错乱或页眉不显示
验证方式很简单：在导言区加一行 ypeout{Engine: jobname}，编译后看日志开头是否输出 xelatex；再检查 VSCode 状态栏右下角是否显示 XeLaTeX，不是的话点它手动切换。
最易被忽略的是 .bib 文件编码——即使 .tex 是 UTF-8，BibTeX 引擎仍要求 .bib 为 ASCII 或 ISO-8859-1，否则 bibtex 步骤直接崩溃。用 biber 替代可解，但需把 backend = bibtex 改成 backend = biber 并确保 .bib 保存为 UTF-8。
