VS Code+Latex配置

原创已于 2024-10-18 11:58:36 修改 · 2w 阅读

196 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #template method

于 2024-10-18 11:51:24 首次发布

Latex 专栏收录该内容

2 篇文章

订阅专栏

声明：

本文内容多来源于网络，主要参考这篇文章，写本文的目的主要是为了记录自己配置VS Code+Latex的过程，希望对大家有所帮助。

至于为什么要使用VS Code+Latex编译Latex，请移步我的另一篇博客overleaf和VS Code+Latex对比，话不多说，直接步入正题。

第一步：安装Tex Live

在该地址点击下载安装包，安装包较大，大约6G左右。

在这里插入图片描述

打开安装包，选择该文件，以管理员身份运行打开，进行安装，安装过程比较缓慢，大约几十分钟，请耐心等待。

安装完成后，win+R键输入cmd，打开cmd命令窗口

在cmd终端键入xelatex -v，检验是否安装成功，出现以下版本号即为安装成功。

此步也可能出现xelatex不是内部命令也不是可运行的程序，但是不用担心，这只是Tex Live的软件路径没有添加到系统环境变量中，并无太大影响。实在觉得不放心，可以按照以下步骤添加环境变量。

还是win+R键输入sysdm.cpl，进入以下界面

选择高级并点击环境变量

进入环境变量后，双击Path打开

进入以下界面

在该界面中，点击新建，将xelatex.exe所在路径复制过来，然后点击确定即可。

xelatex.exe所在路径通常在安装路径的\texlive\2024\bin\windows文件夹里。
因此，我们只需要把它的地址复制添加到系统环境变量中。

然后再win+R键输入cmd，输入xelatex -v，回车，便会发现安装成功。

第二步：安装VS Code

VS Code安装过程比较简单，在此不过多赘述，不会的同学点击这里。

第三步：VS Code下载LaTex Workshop插件并配置环境变量

打开VS Code，点击左侧扩展图标，搜索LaTex Workshop,点击第一个进行下载安装。

这时我们随便打开一个Latex模板，这里给大家提供一个，点击这里，进入该界面，点击Code，再点击Download ZIP

下载到本地后解压缩打开，在VS Code中打开文件夹，如下图所示：

这里想试的小伙伴可以尝试一下，会发现它是编译不成功的。

我们需要配置环境，在VS Code界面快捷键Ctrl Shift + P，输入Open Settings，回车打开Settings.json文件。

在这里插入图片描述
在文件中的{}中添加以下代码，（该代码来源网络，若有侵权，请告知）。

//------------------------------LaTeX 配置----------------------------------
    // 设置是否自动编译
    "latex-workshop.latex.autoBuild.run":"never",
    //右键菜单
    "latex-workshop.showContextMenu":true,
    //从使用的包中自动补全命令和环境
    "latex-workshop.intellisense.package.enabled": true,
    //编译出错时设置是否弹出气泡设置
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,
    // 编译工具和命令
    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    // 用于配置编译链
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }
    ],
    //文件清理。此属性必须是字符串数组
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk"
    ],
    //设置为onFaild 在构建失败后清除辅助文件
    "latex-workshop.latex.autoClean.run": "onFailed",
    // 使用上次的recipe编译组合
    "latex-workshop.latex.recipe.default": "lastUsed",
    // 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",

注意：

如果在{}中已经存在内容，例如：

{
    "terminal.integrated.commandsToSkipShell": [
        "github.copilot.terminal.suggestCommand",
        "matlab.interrupt"
    ],
    "matlab.mlintpath": "D:\\software\\matlab\\bin\\win64\\mlint.exe",
    "security.workspace.trust.untrustedFiles": "open",
    "markdown-preview-enhanced.previewTheme": "github-light.css",
    "workbench.settings.applyToAllProfiles": [
    
    ],
    "markdown-preview-enhanced.revealjsTheme": "none.css",
    "markdown-preview-enhanced.codeBlockTheme": "github.css",
    "workbench.editor.autoLockGroups": {
        "terminalEditor": false
    },
    "workbench.editor.decorations.badges": false,
    "security.workspace.trust.enabled": false,
    "git.path": "D:/software/Git/Git/cmd/git.exe"
}

若代码块最后一行末尾没有英文,，则要先在该行代码后添加英文,，再在其后粘贴Latex环境代码，这是json文件的编写规则。按照上述示例，也就是需要在

"git.path": "D:/software/Git/Git/cmd/git.exe"

后添加英文,，即：

"git.path": "D:/software/Git/Git/cmd/git.exe",

再在其后添加环境代码并保存Settings.json文件。

第四步：编译`.tex`文件

这时我们再打开上面给的Latex模板，打开main.tex文件夹，这时我们发现右侧多了一个TEX的图标，这就是LaTex Workshop扩展。

我们点击它打开，再点击左上角构建LaTex中的xelatex $\rightarrow$ bibtex $\rightarrow$ xelatex*2

在这里插入图片描述

注意：

如果编译文件涉及到参考文献，则必须选择该编译链xelatex $\rightarrow$ bibtex $\rightarrow$ xelatex*2

编译成功后，界面左下角会显示一个√

编译失败则会显示×，其左侧的!显示的是警告，点击可以查看原因。
点击上方的预览按钮，即可查看生成的.pdf文件。

至此我们整个配置环境结束！

完结撒花，芜湖！🌸🌸🌸

一些其它功能探索

该界面还支持双向定位：

鼠标左键双击PDF文件中任意地方，可以定位到tex文件的相应位置。
在tex文件中光标定位后，点击鼠标右键，选择从光标同步SyncTex，可以定位到PDF文件的相应位置。