VSCode中的LaTeX编写环境配置

2次阅读

vscode 搭建 LaTeX 环境需三步:1. 安装 LaTeX Workshop 插件;2. 安装 TeX 发行版(如 MiKTeX/ macTeX)并验证 pdflatex 命令;3. 配置 latexmk 编译、启用自动构建与 PDF 预览(支持正向/反向同步)。

VSCode中的LaTeX编写环境配置

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 --versionlualatex --version 能正常输出,说明路径已就绪。

VSCode中的LaTeX编写环境配置

php配置文件php.ini的中文注释版

php配置文件php.ini的中文注释版是一本由多位作者编著的有关PHP内部实现的开源书籍。从环境准备到代码实现,从实现过程到细节延展,从变量、函数、对象到内存、Zend虚拟机…… 如此种种,道尽PHP之风流。

VSCode中的LaTeX编写环境配置 376

查看详情 VSCode中的LaTeX编写环境配置

设置编译命令与自动构建

默认情况下,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(绘图)、字体配置等,但日常写作完全够用。

text=ZqhQzanResources