VSCode写LaTex:配置与实时预览

1次阅读

vscode写LaTeX完全可行,关键在安装LaTeX Workshop插件、配置recipe编译链(如xelatex→bibtex→xelatex×2)、搭配Sumatrapdf实现PDF同步预览,并推荐项目级.vscode/settings.json配置。

VSCode写LaTex:配置与实时预览

VSCode 写 LaTeX 完全可行,关键在装对插件、配好编译链、设好预览方式——不用换工具,也能获得接近 TeX Live + TeXstudio 的流畅体验。

核心插件:LaTeX Workshop 是唯一刚需

它不是“之一”,是目前 VSCode 上最成熟、更新最勤、文档最全的 LaTeX 支持插件。安装后自动识别 .tex 文件,提供语法高亮、命令补全、错误跳转、结构大纲、引用检查等基础能力。其他插件(如 LaTeX Utilities)可选,但 Workshop 已覆盖 95% 日常需求。

  • 安装路径:VSCode 扩展市场搜 LaTeX Workshop → 点击安装 → 重启 VSCode
  • 确认生效:打开一个 .tex 文件,状态栏右下角应显示“LaTeX”和当前编译器(如 xelatex)
  • 别手动启用“LaTeX Language Support”之类老插件——它已被 Workshop 内置替代

编译配置:用 recipe 而非单个 command

LaTeX 编译常需多步(latexmk → bibtex → latexmk),靠单条命令容易失败。LaTeX Workshop 推荐用 recipe(配方)统一调度,比手动敲命令或改 settings.json 更稳定。

  • 推荐 recipe(写入 .vscode/settings.json):
  • "latex-workshop.latex.recipe.default": "xelatex ➞ bibtex ➞ xelatex ✕2"
  • 对应实际命令链:xelatexbibtexxelatexxelatex(解决交叉引用)
  • 若不用 BibTeX,直接用 "latexmk" 配方(需系统已装 latexmk),它会自动判断是否需要 bibtex/biber

实时预览:PDF 同步 + 自动刷新

VSCode 本身不渲染 PDF,但可通过外部 PDF 阅读器(如 SumatraPDF / Skim / Evince)实现反向/正向同步,配合自动刷新,效果接近“实时”。

VSCode写LaTex:配置与实时预览

SkyReels

SkyReels是全球首个融合3D引擎与生成式AI的AI视频创作平台

VSCode写LaTex:配置与实时预览 1252

查看详情 VSCode写LaTex:配置与实时预览

  • windows 用户装 SumatraPDF(轻量、支持 SyncTeX、免费),设置路径:
    "latex-workshop.view.pdf.viewer": "external",<br>   "latex-workshop.view.pdf.external.viewer.command": "C:/Program Files/SumatraPDF/SumatraPDF.exe",<br>   "latex-workshop.view.pdf.external.viewer.args": ["%PDF%"]
  • 开启正向同步(光标定位到 PDF):快捷键 Ctrl+Alt+J(Win/linux)或 Cmd+Alt+Jmac
  • 开启反向同步(PDF 点击跳回源码):SumatraPDF 中双击 PDF 文字 → 自动跳转到对应 .tex 行
  • 保存即编译 + 预览:开启 "latex-workshop.latex.autoBuild.run": "onFileChange"

小而实用的配置建议

让写作更顺手,不花哨但管用。

  • 关闭自动插入 end{...}(易误触):
    "latex-workshop.intellisense.package.exclude": ["all"] 或禁用 “Auto Insert end{}” 选项
  • 中文支持无脑用 xelatex + ctex 宏包,不用折腾 CJK 或 lualatex 兼容性
  • 项目级配置优先放 .vscode/settings.json,而非全局用户设置,避免不同论文格式冲突
  • 编译日志报错卡住?按 Ctrl+Shift+P → 输入 “LaTeX: Kill Compiler” 强制终止,再重试

基本上就这些。不用装新编辑器,也不用学新语法,VSCode + LaTeX Workshop 搭配得当,写论文、做讲义、整公式都稳得住。

text=ZqhQzanResources