VS code + miktex + 内置pdf阅读器配置latex编译环境

最新推荐文章于 2025-03-25 13:01:55 发布

皆易

最新推荐文章于 2025-03-25 13:01:55 发布

阅读量4k

点赞数 8

分类专栏： latex 文章标签： latex 编辑器 vscode

本文链接：https://blog.csdn.net/qq_15950515/article/details/121372896

版权

latex 专栏收录该内容

3 篇文章

订阅专栏

本文介绍如何通过VSCode及其LaTeXWorkshop插件搭建高效LaTeX编辑环境。包括安装配置步骤、自定义编译方案、使用内置PDF阅读器进行正反向搜索等功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

借助VS Code中的LaTeX Workshop的扩展插件，VS Code已经成为目前主流的Latex编写环境之一。个人认为相比于WinEdt好用很多，它有以下几个优点：

LaTeX Workshop具有灵活的自定义特性，可以自定义编译方式、快捷键、自动删除临时文件、自动保存时间间隔等等，且开发者保持长期、高频率的版本迭代；
VS Code本身是一个轻量型的全功能编辑器，支持多种语言，具有开放而丰富的插件环境，许多插件可以提高Latex编写的效率，比如拼写检查与修改、版本控制器、多种主题风格等等；
免费（非常重要的优点）

安装与配置过程比较简洁，可以分为软件安装与插件配置两部分，熟悉的话五分钟就可以可以搞定，不熟悉的话如果没遇到问题也就十分钟以内，遇到问题的话就。。。

安装软件

安装最新版的miktex（实际上很多人使用tex live，其实配置环境是通用的）
安装最新版的VS Code

这两步均比较简单，按照默认步骤来即可。

配置插件

LaTeX Workshop

LaTeX Workshop是利用VS Code编译latex的核心，是广受赞誉的latex编译插件。
在这里插入图片描述
打开VS Code的设置文件settings.json进行设置（可自行百度如何打开），这里给出我的自定义设置：

{
    //latex workshop setting
        // 编译方案，这里定义了四个方案
        "latex-workshop.latex.recipes": [
            // 第一个方案，用于带bib文件的编译
            {
            "name": "pdflatex_bib",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
            },
            // 第二个方案，只使用 pdflatex
            {
                "name": "pdflatex  ",
                "tools": [
                "pdflatex"
                ]
            },
            // 第三个方案，中文支持+bib
            {
                "name": "xelatex_bib",
                "tools": [
                  "xelatex",
                  "bibtex",
                  "xelatex",
                  "xelatex"
                ]
            },
            // 第四个方案，中文支持，无bib
            {
                "name": "xelatex",
                "tools": [
                  "xelatex"
                ]
            },
   
        ],
        // 编译方案中所需的编译工具，包含 pdflatex 和 bibtex
        "latex-workshop.latex.tools": [
            {
                "name": "pdflatex",
                "command": "pdflatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOC%"
                ]
            },
            {
                "name": "bibtex",
                "command": "bibtex",
                "args": [
                    "%DOCFILE%"
                ]
            },
            {
                "name": "xelatex",
                "command": "xelatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOC%"
                ]
            },
        ],

    //自动保存时不编译
    "latex-workshop.latex.autoBuild.run": "never",

    // 每次编译后删除辅助文件
    "latex-workshop.latex.autoClean.run": "onBuilt",

    // 默认使用上一次的编译方案
    "latex-workshop.latex.recipe.default": "pdflatex_bib",

    // LaTeX Workshop - 根据加载包自动加载自动补全
    "latex-workshop.intellisense.package.enabled": true,
    
    // 默认使用内置pdf阅读器进行 PDF 预览
    "latex-workshop.view.pdf.viewer": "tab",

    //右键菜单
    "latex-workshop.showContextMenu": true,
    
}

在设置完成之后，重启VS Code，即可实现latex文件的编译。
在这里插入图片描述
可以看到，LaTex Workshop在左侧提供了tex文件的结构，以及常用符号的latex代码。
以上是我个人的自定义设置，也可根据个人需要自行设置。具体设置方法可查看LaTex Workshop的github页面。
注意，之前很多人采用Sumatra PDF作为外置的pdf阅读器，因为可以配置正向及反向搜索，也即tex文件与pdf文件互相的文本定位。但最新版本LaTex Workshop的内置pdf阅读器已经可以支持正向检索（ctrl+alt+J）和反向检索（ctrl+单击），因此直接采用内置的pdf阅读器即可。故这里没有给出使用外置pdf阅读器的设置方式。
另外，若编译报错的话，必要时可将设置中的"latex-workshop.latex.autoClean.run": “onBuilt”,注释掉，从而可以在临时文件中定位错误。