VSCode 搭建 LaTeX 环境需三步：1. 安装 LaTeX Workshop 插件；2. 安装 TeX 发行版（如 MiKTeX/ MacTeX）并验证 pdflatex 命令；3. 配置 latexmk 编译、启用自动构建与 PDF 预览（支持正向/反向同步）。
VSCode 搭建 LaTeX 编写环境其实不难，关键是装对插件、配好编译链、让自动构建和预览跑起来。下面按实际使用逻辑分几步说清楚。
安装核心插件：LaTeX Workshop
这是 VSCode 里最成熟、功能最全的 LaTeX 插件，支持编译、跳转、自动补全、错误提示、PDF 实时预览等。在扩展市场搜 LaTeX Workshop，安装并重启即可。注意别装错名字相近的其他插件（比如 “LaTeX” 单独一个词的旧版已停更）。
配置 LaTeX 编译器（如 TeX Live 或 MiKTeX）
LaTeX Workshop 本身不带编译器，需提前在系统中装好发行版：
- Windows 推荐 MiKTeX（安装时勾选“添加到系统 PATH”，否则 VSCode 找不到命令）
- macOS 推荐 MacTeX（体积大但完整）或轻量版 BasicTeX（后续缺包再用
tlmgr装） - Linux（如 Ubuntu）可用
sudo apt install texlive-full，或更省空间的texlive-latex-recommended+texlive-latex-extra
装完后终端运行 pdflatex --version 或 lualatex --version 能正常输出，说明路径已就绪。
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
设置编译命令与自动构建
默认情况下，LaTeX Workshop 会尝试用 latexmk（推荐），但需确保它已随发行版安装（MiKTeX 和 MacTeX 默认带，BasicTeX 需手动装：tlmgr install latexmk）。你可以在 VSCode 设置中确认：
- 打开 设置 → Extensions → LaTeX Workshop → LaTeX → Recipes，保持默认的
latexmk配置 - 或在项目根目录加
.latexmkrc文件自定义，例如：$pdf_mode = 1; $out_dir = 'out'; - 保存 .tex 文件后，默认开启「自动构建」（可在设置中开关：Latex-workshop → Latex → Auto Build → On File Change）
PDF 预览与反向同步
编译成功后，按 Ctrl+Alt+V（Win/Linux）或 Cmd+Alt+V（Mac）唤出 PDF 预览面板。支持：
-
正向同步：编辑器光标定位 → PDF 页面跳转（快捷键
Ctrl+Alt+J） - 反向同步：PDF 中双击 → 自动跳回对应源码行（需 PDF 查看器支持，推荐用内置查看器或 Skim（macOS）、SumatraPDF（Windows））
- 若用 SumatraPDF，需在设置中填入路径：
"latex-workshop.view.pdf.viewer": "external",<br>"latex-workshop.view.pdf.external.viewer.command": "C:/path/to/SumatraPDF.exe",<br>"latex-workshop.view.pdf.external.viewer.args": ["%PDF%"]
基本上就这些。配好后新建 main.tex，写个简单文档测试编译和预览，流程就跑通了。后续可按需加 Biber（参考文献）、Shell-escape（绘图）、字体配置等，但日常写作完全够用。
