详细教程:在vscode上配置tex环境

最近又配置了一遍LaTeX环境,发现直接安装使用TexLive和其自带的编译器是最好的,既方便又功能齐全。可以看这个教程

=======================以下是正文===========================

本文适合第一次接触Latex,并且希望在VSCode上使用Latex编写论文的初学者。环境是win10 + VSCode + MikTex

为什么选择VSCode+MikTex

VSCode相当于一个加强版的文本编辑器。比起各种重量级的IDE(eclipse,pycharm等等),它的体积很小,普适性强,使用简单。能够提供简单的代码管理功能,以及高亮,自动缩进等代码书写帮助,在很多时候就已经够用了。笔者就很不喜欢在电脑上为每个语言专门安装一个工具,所以没有选择TexStudio,而是使用VSCode。

MikTex,其实只是一种选择而已。很多人可能会疑惑,LATEX、CTEX、TEXLIVE、MIKTEX这一大堆东西有什么关系。

TeX是由著名的计算机科学家Donald E. Knuth(高德纳)发明的排版系统,利用TeX可以很容易地生成高质量的dvi文件,打印输出。 ----- 摘自百度百科

总之,由于Tex是开源的,所以市面上就有了ctex、texlive、miktex等这些和tex有关系的产品,我们一般选择其中一个就行。这里笔者选择了Miktex,原因很简单,因为第一次配置就成功运行了。同时MiKTex有一个好处就是当引用没有安装的宏包时会自动下载相应的宏包。

安装配置步骤

1.下载vscode

这一步很简单,百度搜索vscode,进入官网,找到适合自己的平台,下载解压即可。

可以运行看看,默认的界面就是下面这样👇

image

2.在VScode内安装LaTeX Workshop扩展组件

点击左侧菜单最后一个按钮,即extensions按钮,在组件商店搜索LaTeX Workshop,点击install安装即可。

image

3.下载并安装Miktex

点这个链接https://miktex.org/download进入Miktex下载页面,下载到自己的指定目录即可。下载完应该会有basic-miktex-2.9.7255-x64.exe这个文件。

点击上面提到的exe文件,即可开始安装,一直“下一步”即可。

image

结束后应该会自动运行MikTex Console。如果没运行,可以去windows菜单找到最近安装的MikTex Console手动运行。

image

3.配置VScode以支持Tex

按下快捷键"ctrl + ,"唤出设置界面,在搜索框输入settings.json,在搜索结果中点击下图中红线标出部分。

image

修改配置文件为如下内容

其中第一行的python部分是我电脑的个人配置,大家可以删除,或是改成自己的路径。

{
    "python.pythonPath": "D:\\Anaconda3\\pythonw.exe",
    "latex-workshop.view.pdf.viewer": "tab",
    "window.zoomLevel": 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"
            ]
        }
    ],
      "latex-workshop.latex.autoClean.run": "onBuilt"
}

按下"ctrl + s"保存一下即可。

4.运行第一个tex文件

在自己心仪的目录下建一个工作文件夹,然后在vscode中打开这个目录。

点击file-->open folder,找到自己已经建好的目录。

在目录下新建一个文件,以.tex作为后缀,这就是tex文件的格式了。

image

文件中输入以下代码,作为第一篇tex文章(虽然只是个hello world,哈哈)


\documentclass{article}

    \begin{document}

        Hello world!

    \end{document}

这时我们应该会看到左下角进入build状态或者是报错,

看到报错也不要慌!

这是由于MikTex相关的宏包和配置还未安装好。

这时,MikTex Console应该会弹出窗口,问你是否下载xxx包,点击install即可。

待所有的依赖都安装好了,再在刚才的demo.tex文件下按"ctrl + s"进行保存并编译。

当左下角由build变为对勾之后,就说明代码运行成功了。

如果一直未成功,应该是MikTex安装的宏包还未被VScode识别,重启VScode即可。

4.生成pdf

点击右上角的放大镜图标,就可以在vscode页面内生成pdf了~

pdf文件默认会保存在文件目录下。

每次做了修改,按下ctrl+s重新编译,对应的pdf也会更新。

image
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。