当前位置: 首页 > news >正文

VS Code 配置 LaTeX 完整教程:从 TeXstudio 迁移到 LaTeX Workshop

VS Code 配置 LaTeX 完整教程:从 TeXstudio 迁移到 LaTeX Workshop

之前使用 TeXstudio 编译正常,但切换到 VS Code 后出现参考文献、章节、图表编号无法显示,主要原因是:

  • VS Code 需要额外安装 LaTeX 编译扩展;
  • 工程路径中的中文字符可能导致编译器乱码;
  • 参考文献需要执行 BibTeX;
  • 章节、图表和公式编号需要多轮编译;
  • VS Code 的普通“运行”按钮不是 LaTeX 编译按钮。

本文以 Windows、TeX Live 和 VS Code 为例,介绍完整配置方法。


一、LaTeX 编译环境的组成

LaTeX 项目通常包含三部分:

VS Code ↓ LaTeX Workshop 扩展 ↓ TeX Live / MiKTeX 编译环境

其中:

  • VS Code:编辑器;
  • LaTeX Workshop:负责调用编译命令;
  • TeX Live 或 MiKTeX:真正执行 XeLaTeX、BibTeX 等编译程序。

TeXstudio 本身也是编辑器,之前能够正常编译,说明电脑中大概率已经安装了 TeX Live 或 MiKTeX。

终端检查VS Code、LaTeX Workshop、TeX Live版本信息

建议在终端检查:

xelatex--version bibtex--version latexmk--version

如果能够显示版本号,说明编译环境已经安装。

LaTeX Workshop 官方安装说明:

LaTeX Workshop Installation


二、安装 VS Code 扩展

在 VS Code 左侧打开扩展商店,搜索并安装:

LaTeX Workshop

也可以按:

Ctrl + P

输入:

ext install latex-workshop

LaTeX Workshop 可以提供:

  • 编译.tex文件;
  • 自动调用 BibTeX;
  • 生成 PDF;
  • PDF 与源码正反向跳转;
  • 公式、章节和引用补全;
  • 编译错误和警告提示。

图1:VS Code 扩展商店中的 LaTeX Workshop


三、工程路径尽量使用英文

Windows 下,较旧版本的 TeX Live、Perl 和 latexmk 可能无法正确处理中文路径。

不推荐:

D:\中文文件\中文路径\论文排版2026\

建议使用:

D:\LaTeX\Paper_path\project_path

工程目录可以包含:

project_path/ ├── paper.tex ├── refs.bib ├── figs/ └── .vscode/ └── settings.json

然后在 VS Code 中选择:

文件 → 打开文件夹

打开整个工程目录,而不是只打开某个.tex文件。

图2:VS Code 中打开完整 LaTeX 工程目录


四、配置settings.json

在工程目录下创建:

.vscode/settings.json

写入以下内容:

{"latex-workshop.latex.tools":[{"name":"xelatex","command":"xelatex","args":["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOC%"]},{"name":"bibtex","command":"bibtex","args":["%DOCFILE%"]}],"latex-workshop.latex.recipes":[{"name":"XeLaTeX -> BibTeX -> XeLaTeX x2","tools":["xelatex","bibtex","xelatex","xelatex"]}],"latex-workshop.latex.recipe.default":"XeLaTeX -> BibTeX -> XeLaTeX x2","latex-workshop.view.pdf.viewer":"tab"}

其中:

%DOC%

表示当前主.tex文件的完整路径。

%DOCFILE%

表示不带扩展名的主文件名,例如:

paper

五、为什么需要四步编译

参考文献、章节、图、表和公式编号不能通过一次编译完成。

完整流程为:

第一次 XeLaTeX ↓ 生成 .aux 文件 ↓ BibTeX 读取 refs.bib ↓ 生成 .bbl 文件 ↓ 第二次 XeLaTeX ↓ 加载参考文献和交叉引用 ↓ 第三次 XeLaTeX ↓ 确定最终编号

因此配置中的:

"tools":["xelatex","bibtex","xelatex","xelatex"]

不能删除或重复。


六、正确的编译方式

不要使用 VS Code 右上角普通的三角形“运行”按钮。

应使用以下方法之一。

方法一:快捷键

Ctrl + Alt + B

方法二:命令面板

按:

Ctrl + Shift + P

输入:

LaTeX Workshop: Build with recipe

选择:

XeLaTeX -> BibTeX -> XeLaTeX x2

方法三:左侧 TeX 面板

点击左侧的 TeX 图标,然后点击:

Build LaTeX project

图3:LaTeX Workshop 的 Build with recipe 菜单


七、如何查看编译日志

编译后按:

Ctrl + J

打开底部面板,点击:

OUTPUT

在右侧下拉框中选择:

LaTeX Compiler

正常日志应该包含:

Running 'xelatex ...' Running 'bibtex paper' Running 'xelatex ...' Running 'xelatex ...'

最后应看到:

Output written on paper.pdf

以及:

Transcript written on paper.log

八、参考文献的正确配置

主文件末尾使用 BibTeX 时,应写成:

\bibliographystyle{cas-model2-names} \bibliography{refs}

注意不要写成:

\bibliography{refs.bib}

正文引用示例:

Recent studies have explored lightweight networks \citep{wang2024yolov9}.

参考文献文件应位于:

refs.bib

并且和主文件位于同一个工程目录中。


九、常见 BibTeX 错误

1. 重复引用键

错误:

Repeated entry---line ...

说明多个条目使用了相同的键,例如:

@article{liu2024edge,

同一个引用键只能出现一次。


2. 不支持的条目类型

错误:

entry type for "yolov8_ultralytics" isn't style-file defined

例如:

@software{yolov8_ultralytics,

可以改为:

@misc{yolov8_ultralytics, author = {Jocher, Glenn and Chaurasia, Ayush and Qiu, Jing}, title = {Ultralytics YOLOv8}, year = {2023}, howpublished = {\url{https://github.com/ultralytics/ultralytics}} }

3.@inproceedings缺少booktitle

错误:

empty booktitle in wang2024yolov10

如果条目类型是:

@inproceedings

应使用:

booktitle = {Advances in Neural Information Processing Systems},

而不是:

journal = {Advances in Neural Information Processing Systems},

4. 清理后直接运行 BibTeX

如果出现:

I couldn't open file name `COMPAG_LED-Inst.aux'

说明还没有先运行 XeLaTeX。

正确顺序是:

XeLaTeX → BibTeX → XeLaTeX → XeLaTeX

不能清理辅助文件后直接运行 BibTeX。


十、章节、图表和公式引用

推荐使用不含空格的标签:

\section{Related Work} \label{sec:related-work}

正文引用:

Section~\ref{sec:related-work}

图片:

\caption{Overall architecture of the proposed framework.} \label{fig:framework}

正文引用:

Fig.~\ref{fig:framework}

表格:

\caption{Experimental results.} \label{tab:results}

正文引用:

Table~\ref{tab:results}

\label的推荐位置:

\caption{...} \label{fig:example}

也就是放在\caption后面。


十一、如何清理并重新编译

如果 PDF 中仍然出现:

??

或者:

[?]

可以清理辅助文件。

按:

Ctrl + Shift + P

执行:

LaTeX Workshop: Clean up auxiliary files

然后重新执行:

LaTeX Workshop: Build with recipe

选择:

XeLaTeX -> BibTeX -> XeLaTeX x2

最后按:

Ctrl + Alt + V

重新打开 PDF。


十二、日志中的警告如何判断

以下警告通常不影响 PDF 生成:

Underfull \hbox Overfull \hbox

它们表示排版时某些行太松或太宽。

以下警告说明交叉引用还没有完成:

Reference ... undefined Citation ... undefined

第一次 XeLaTeX 编译时出现这些警告是正常的,只要最终一次编译中不再出现即可。

真正需要优先处理的是:

There were ... error messages

或者:

Fatal error

总结

从 TeXstudio 迁移到 VS Code,最重要的是掌握下面这条逻辑:

安装 TeX Live 或 MiKTeX ↓ 安装 LaTeX Workshop ↓ 打开完整工程文件夹 ↓ 配置 .vscode/settings.json ↓ 使用 XeLaTeX -> BibTeX -> XeLaTeX x2 ↓ 查看 LaTeX Compiler 日志 ↓ 重新打开生成的 PDF

只要工程路径正常、refs.bib语法正确,并且使用完整的四步编译流程,参考文献、章节、图表和公式编号就可以在 VS Code 中正常生成。

http://www.jsqmd.com/news/1177951/

相关文章:

  • 基于YOLOv8的美国硬币识别系统:从数据标注到GUI开发全流程实战
  • PyTorch LSTM实战:从温度预测跑通第一个时序模型
  • 基于C++ Workflow构建10万QPS高并发广告竞价系统
  • 浪琴中国官方售后服务中心|服务电话及24小时详细地址权威信息声明(2026年7月更新) - 浪琴服务中心
  • 非刚性点云配准与高斯溅射优化:解决视频扩散模型时序一致性问题
  • STM32F407与CMT-8540S音频模块开发实战
  • Godot 2D沙盒游戏开发:动画树、自动瓦片与昼夜系统实战
  • 基于LangGraph构建智能RAG代理系统:从大模型基础到生产级实践
  • Spring Boot 启动失败排查:如何区分多 Bean 冲突与清理阶段异常
  • 企业级Java开发中的常见陷阱与最佳实践
  • 2026 年至今,台东优秀的芦苇苗批发定制厂家有哪些,别再信“量大从优”的鬼话,这种芦苇苗越买越亏! - 企业信息推荐【官方】
  • 欧米茄清洗保养价格表及售后服务流程说明权威公示(2026年7月最新) - 欧米茄服务中心
  • Maven package/install/deploy 全流程解析:从本地 JAR 到远程仓库的 4 步实践
  • Silk v3音频解码:从原理到实战,3分钟解决微信QQ语音转换难题
  • GUI Agent:从视觉理解到自动化执行的技术突破与应用
  • ToB客户地图的梳理思路与方法
  • AI赋能激光加工:视觉识别、参数优化与缺陷检测实践
  • 2026年7月湖北东风六驱越野卡车/六驱越野厢式车选厂综合指南_湖北神宇专用汽车有限公司 - 品牌宣传支持者
  • PlantUML 实战:5分钟将UML类图描述自动转换为标准图表
  • PyTorch深度学习实战:从环境配置到模型部署的完整指南
  • 2026达州漏水检测维修口碑榜TOP5权威推荐:正规防水补漏公司甄选-卫生间/厨房/阳台/屋顶/地下室渗漏水精准查漏:房屋防水补漏避坑指南 - 安佳防水
  • 学数据分析一定要会Python吗?先看你的岗位目标
  • ESP8266 STA/AP模式 3 种物联网应用场景实测:MQTT上报、TCP服务器、UDP广播
  • 百达翡丽中国官方售后服务中心|地址与联系电话权威信息声明(2026年7月更新) - 百达翡丽服务中心
  • 研发选型求助:串口屏宽温要求和成本怎么平衡?
  • Zotero 高级配置:5 个隐藏首选项优化文献管理与同步效率
  • 为什么 Agent 越聊越慢?聊聊 Context(上下文)管理
  • TAS5414C-Q1与PIC18F4458芯片对比:汽车音频系统设计指南
  • Deepseek大模型:从代码生成到系统设计的AI助手实战指南
  • SlowFast算法实战:从原理到代码实现的行为识别完整指南