轻松搭建LaTeX+VSCode编辑环境（以CTeX为例）

轻松搭建 $\text{LATEX}$ + VSCode 编辑环境（以CTeX为例）

WinEdit 或 TexStudio 作为常用老牌的TeX编辑器, 受众广泛, 操作效率高. 然而其原始落后的界面实在难以和美观便捷的VSCode媲美. 本文提供了一种操作难度较低的, 将VSCode变为 $\text{LATEX}$ 编辑器, 并实现侧栏伪实时渲染的方法.

在本教程中, 我们使用 CTeX 作为 $\text{LATEX}$ 基础库.

1. 首先于こ↑こ↓下载 CTeX. 软件包大小可按需选择.

2. 于 VSCode 中下载并安装如下扩展:

LaTeX language support

LaTeX Preview

LaTeX Workshop

3. 在确认 CTeX 安装完毕后, 打开VSCode, 编辑 ettings.json, 在其中加入以下语句:

3.1 若没有其余的自定义用户配置: 粘贴

{
"latex-workshop.latex.tools": 
[
    {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOC%"
        ]
    },
    {
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "pdflatex",
        "command": "pdflatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "bibtex",
        "command": "bibtex",
        "args": [
            "%DOCFILE%"
        ]
    }
],
"latex-workshop.latex.recipes": 
[
    {
        "name": "xelatex",
        "tools": [
            "xelatex"
        ]
    },
    {
        "name": "pdflatex",
        "tools": [
            "pdflatex"
        ]
    },
    {
        "name": "latexmk",
        "tools": [
            "latexmk"
        ]
    },
    {
        "name": "pdflatex -> bibtex -> pdflatex*2",
        "tools": [
            "pdflatex",
            "bibtex",
            "pdflatex",
            "pdflatex"
        ]
    }
],

}

3.2 若已经存在其余的用户配置:
删除原配置代码末尾的 } , 并在最后一句控制语句末尾加上一个英文逗号, 随后粘贴下列代码:

"latex-workshop.latex.tools": 
[
    {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOC%"
        ]
    },
    {
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "pdflatex",
        "command": "pdflatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "bibtex",
        "command": "bibtex",
        "args": [
            "%DOCFILE%"
        ]
    }
],
"latex-workshop.latex.recipes": 
[
    {
        "name": "xelatex",
        "tools": [
            "xelatex"
        ]
    },
    {
        "name": "pdflatex",
        "tools": [
            "pdflatex"
        ]
    },
    {
        "name": "latexmk",
        "tools": [
            "latexmk"
        ]
    },
    {
        "name": "pdflatex -> bibtex -> pdflatex*2",
        "tools": [
            "pdflatex",
            "bibtex",
            "pdflatex",
            "pdflatex"
        ]
    }
],

}

在确认 settings.json 无报错后, 将其保存并关闭.

至此, 全部基本配置都已设置完毕, 我们可以在VSCode中编辑, 预览和编译 $\text{TEX}$ 文件：

1. 编辑: 使用VSCode新建或打开 .tex 文件 .
2. 预览: 我们如同预览MarkDown文档一样, 打开侧边栏显示当前 $\text{TEX}$ 文件的渲染结果.
3. 编译: 快捷键为 Ctrl+Alt + B.