尧图网站建设 尧图网络
  • 首页
  • 关于我们
  • 服务项目
  • 案例展示
  • 建站流程
  • 资讯中心
  • 联系我们
首页/资讯中心/详情

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

VS Code 配置 LaTeX 完整教程:从 TeXstudio 迁移到 LaTeX Workshop
📅 发布时间:2026/7/13 3:16:56

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 中正常生成。

相关新闻

  • 技术博客创作规范:聚焦软件开发与工程实践
  • 2026年7月最新天津宝玑官方售后服务热线与网点地址查询 - 亨得利钟表维修中心
  • 基于C++ Workflow构建10万QPS高并发广告竞价系统

最新新闻

  • 01 | 为什么先规划学习路径
  • P2P 金融系统银行存管对接:万信金融 3 种分布式事务方案对比与选型
  • Kali Linux中文渗透测试环境搭建:ibus输入法深度配置与避坑指南
  • AI代码助手四代演进:从语法补全到自主开发的进化之路
  • 《鸣潮》3.5版本「遗音扶剑,荡梦而歌」上线 UU远程云电脑助力低配置设备畅玩
  • Unity UI Toolkit实战:从零构建可交互计数器,掌握数据绑定与响应式UI

日新闻

  • AI推荐结果怎么优化:适合深圳少儿素质培训机构的GEO服务商哪家好?全程零代码SAAS操作
  • RAG 实战教学完全指南
  • 企业级API网关架构深度解析:IBM Microgateway的技术实现与选型指南

周新闻

  • IX9104 PCIe5.0 高速交换芯片@ACP#完整规格 + 应用场景总结
  • Unity游戏集成Coze智能体:实现NPC智能对话与知识库联动
  • SAP EPIC 建行回单查询:从标准类CL_EPIC_EXAMPLE_CN_CCB_GHTD到Z类的5处关键修改

月新闻

  • 2026年6月公司网站搭建最新热门渠道测评:四大低成本/零代码平台对比+避坑
  • 【Linux】Linux arm 编译QT程序,出现expected “}“报错
  • 【MATLAB例程】四基站二维AOA定位与距离辅助增强对比仿真。基于角度观测和测距修正的固定目标平面定位精度分析

关于尧图

  • 公司简介
  • 团队介绍
  • 企业文化
  • 荣誉资质

服务项目

  • 定制开发
  • 电商建站
  • UI 设计
  • 运维服务

快速链接

  • 案例展示
  • 建站流程
  • 常见问题
  • 资讯中心

联系方式

  • 📍北京市朝阳区互联网产业园 A 座 10 层
  • 📞400-888-8888
  • ✉️contact@rkmt.cn
  • 🕐周一至周日 9:00-21:00

© 2024 北京尧图网络科技有限公司 版权所有 | 京 ICP 备 XXXXXXXX 号