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 能正常输出,说明路径已就绪。
php配置文件php.ini的中文注释版是一本由多位作者编著的有关PHP内部实现的开源书籍。从环境准备到代码实现,从实现过程到细节延展,从变量、函数、对象到内存、Zend虚拟机…… 如此种种,道尽PHP之风流。
376 设置编译命令与自动构建
默认情况下,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(绘图)、字体配置等,但日常写作完全够用。