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

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"- 对应实际命令链:
xelatex→bibtex→xelatex→xelatex(解决交叉引用) - 若不用 BibTeX,直接用
"latexmk"配方(需系统已装latexmk),它会自动判断是否需要 bibtex/biber
实时预览:PDF 同步 + 自动刷新
VSCode 本身不渲染 PDF,但可通过外部 PDF 阅读器(如 SumatraPDF / Skim / Evince)实现反向/正向同步,配合自动刷新,效果接近“实时”。
- 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+J(mac) - 开启反向同步(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 搭配得当,写论文、做讲义、整公式都稳得住。