VsCode 使用Latex最新教程

VsCode 使用Latex

一、下载安装VsCode

参考教程：https://blog.youkuaiyun.com/Gerald_Jones/article/details/121512837

二、下载安装TeX Live

常用的TeX编译器有两种， TeXLive 和 MiKTeX 。前者大而全(接近6GB)，后者则相对小巧玲珑。（空间足够的话建议下载安装TexLive版本）

Note：安装前保证此系统无其他（关于latex）的编排软件

2.1 MiKTex版本

MiKTex下载网址：https://miktex.org/download


添加环境变量：这里已经自动添加（安装时选择的是当前用户，此处为User Path），此处没有路径的需手动添加，也比较简单这里不再赘述。

但是遇到了问题：
意味着系统没有发现miktex相关的环境，要配置系统的环境变量

重启VsCode即可解决此问题

2.2 TeXLive版本

TeXLive下载网址：https://tug.org/texlive/acquire-netinstall.html

华为云镜像：https://mirrors.huaweicloud.com/CTAN/systems/texlive/Images/

阿里云镜像：https://mirrors.aliyun.com/CTAN/systems/texlive/Images/

选择镜像网站下载：

安装流程
选择安装文件夹（因为安装文件较多，整体占用空间较大，请合理选择安装路径）

选择安装语言

静静等待即可
我是安装在D盘（台式机固态硬盘，也安装了1h40+mins）
安装之后不需要配置环境路径，可以查看一下，系统环境变量里面已经添加了

三、安装插件LaTex Workshop

3.1 在VsCode中安装插件LaTex Workshop

3.2 setting.json配置

此处参考知乎Marvey的一篇文章

和优快云博主的一篇文章

或者菜单栏中：文件-首选项-设置

接下来

{
    "security.workspace.trust.untrustedFiles": "open",  // 允许不受信任的文件导入信任工作区，不提示
    "python.defaultInterpreterPath": "C:\\ProgramData\\Anaconda3\\envs\\tensorflow\\python.exe",    // python 环境
    "code-runner.runInTerminal": true,  // 在终端中允许输入
    "workbench.iconTheme": "vscode-icons",  // 文件图标
    "workbench.colorTheme": "Eva Light Bold",   //系统主题
    "workbench.editorAssociations": {
        "*.npz": "default"
    },
    "vsicons.dontShowNewVersionMessage": true,  // 新版本更新提示消息

    "latex-workshop.latex.recipes": [
        // 写中文论文所以用xelatex编译，在latex-worshop.latex.recipes中把xelatex放在首位
        // 要写英文论文就把latexmk放在第一位
        {
            "name": "xelatex",
            "tools": [
                "xelatex"
            ],
        },
        {
            "name": "pdflatex",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "xe->bib->xe->xe",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdf->bib->pdf->pdf",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }
    ],
    // 将 tools 中的 %DOC%替换成%DOCFILE%就可以支持中文路径下的文件了
	// 编译工具如果是Tex-Live 则在command条目不需要"miktex"
    // 编译工具如果是MikTex的条件下 command条目此内容需要添加"miktex-"
    "latex-workshop.latex.tools": [
        // 编译工具和命令
        {
            "name": "xelatex",
            "command": "miktex-xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "latexmk",
            "command": "miktex-latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "%DOCFILE%"
            ]
        }, 
        {
            "name": "pdflatex",
            "command": "miktex-pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        }, 
        {
            "name": "bibtex",
            "command": "miktex-bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],    
    //清除辅助文件
    "latex-workshop.latex.autoClean.run": "onBuilt",
    "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",
    ], 
    // 用内置pdf阅读器查看
    // "latex-workshop.view.pdf.viewer": "tab", 
    "latex-workshop.view.pdf.viewer": "external",

    // 用外部pdf阅读器查看
    "latex-workshop.view.pdf.external.viewer.command": "C:/Program Files/SumatraPDF/SumatraPDF.exe",
    "latex-workshop.view.pdf.external.viewer.args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        "-inverse-search",
        "\"C:/Users/Gsk/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \":/Users/Gsk/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
        "%PDF%"
    ],

    "latex-workshop.view.pdf.external.synctex.command": "C:/Program Files/SumatraPDF/SumatraPDF.exe",
    "latex-workshop.view.pdf.external.synctex.args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        "-inverse-search",
        "\"C:/Users/Gsk/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \"C:/Users/Gsk/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
        "%PDF%",
    ],
    // LaTeX Workshop 默认保存的时选择不自动编译
    "latex-workshop.latex.autoBuild.run": "never",
    // 屏蔽编译出错，插件弹出的警告框
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,

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

3.3 测试tex文件

\documentclass{article}
\usepackage{lipsum}
\begin{document}
\lipsum[1]
\[  
 a^2 + b^2 =c^2
\]
\lipsum[2]
\end{document}

使用SumatraPDF预览方法：

• Ctrl+Alt+v
• 左侧栏点击Tex，点击右上角的阅读放大镜即可

显示如下

四、PDF阅读器

此处建议下载绿色轻便的PDF阅读器：sumatra pdf

下载页面其貌不扬，体验除了Adobe Acrobat DC功能上弱一些，目前没有比这个更简便的pdf，个人观点。