VSCode 本身不编译 LaTeX，需搭配 TeX 发行版（如 TeX Live/MacTeX）和 LaTeX Workshop 插件协同工作；必须配置完整工具链、确保 latexmk 可用，并正确设置主文件与编译引擎。

VSCode 本身不编译 LaTeX，它只是编辑器；真正完成编译、生成 PDF 和实时预览的，是外部工具链（latexmk、pdflatex 等） + 插件（LaTeX Workshop）协同工作的结果。没配对环境，写完只能看源码，看不到 PDF。

必须安装的底层编译工具：TeX 发行版

LaTeX 不是单个程序，而是一套排版系统，依赖完整的 TeX 工具链。Windows 推荐 TeX Live（全功能、更新勤），macOS 用 MacTeX（含 GUI 工具），Linux 多用系统包管理器安装（如 Ubuntu 的 sudo apt install texlive-full）。不要只装 pdflatex 单独二进制——latexmk 会调用 bibtex、makeindex、lualatex 等多个命令，缺一不可。

• 验证是否就位：终端运行 latexmk --version 和 pdflatex --version，都应返回版本号
• 若报 “command not found”，说明 PATH 没包含 TeX bin 目录（Windows 常见于未勾选“Add to PATH”安装选项）
• Mac 用户若用 Homebrew 安装 texlive，默认不带完整宏包，建议直接下 MacTeX 镜像

VSCode 插件核心：LaTeX Workshop

这是目前唯一成熟支持完整工作流的插件：自动检测根文件、一键编译（Ctrl+Alt+B）、反向搜索（PDF 点击跳回源码）、正向搜索（源码跳转到 PDF 对应位置）、BibTeX 集成、错误高亮定位。别装其他轻量插件——它们基本只做语法高亮，不处理构建逻辑。

• 安装后无需额外配置即可编译简单文档，但需确保 latexmk 在系统 PATH 中（否则插件会提示 “Could not find latexmk”）
• 编译命令默认走 latexmk -pdf -file-line-error -synctex=1 -interaction=nonstopmode，这个参数组合兼顾错误定位、SyncTeX 支持和容错性
• 若项目含中文，需在主 .tex 文件导言区明确指定引擎，例如用 \usepackage{ctex}（推荐）或切换为 lualatex 编译器（需在插件设置里改 latex-workshop.latex.recipe.default）

常见编译失败原因与快速排查

90% 的“点编译没反应”或“PDF 不更新”问题，和 VSCode 无关，而是路径、权限或配置错位。

• File not found: main.aux 或 Undefined control sequence：多半是没设主文件（右键 .tex → “Set as LaTeX root document”），或导言区漏了 \documentclass{...}
• 保存后 P

  

  DF 不自动刷新：检查插件设置 latex-workshop.view.pdf.viewer 是否为 tab 或 external；若用外部阅读器（如 SumatraPDF / Skim），必须启用 SyncTeX 并配置路径（latex-workshop.view.pdf.external.viewer.command）
• 中文乱码或公式不渲染：确认编译器匹配宏包——ctex 默认用 xelatex，若强行用 pdflatex 会炸；检查字体是否系统可访问（尤其是 Windows 下用 simhei.ttf 等本地字体时）
• 引用（\cite{}）显示 [? ]：BibTeX 未运行，或 .bib 路径不对，或编译流程没包含 bibtex 步骤（latexmk 默认包含，但手动配 recipe 时容易漏）

最易被忽略的一点：LaTeX Workshop 的日志输出（LaTeX Compiler 面板）比终端输出更详细，且点击错误行能直接跳转；很多人只盯着终端报错，却没打开插件自己的日志视图，导致卡在明显可解的问题上。