[开发工具]Mac 使用 vscode 写 latex

平时写 latex 都依赖 在线编辑器 overleaf, 但这个网站在一些 ddl 时会偶尔崩溃，影响体验，因此本文尝试在 mac 环境中 用 vscode 写 latex。

安装 mactex

mactex 的官网下载地址：戳这里（国内用户下载可能会很慢）

这里提供一些镜像，可直接点击下载：

清华大学镜像：戳这里
北京交通大学镜像：戳这里
上海交通大学镜像：戳这里
中国科技大学镜像：戳这里
重庆大学镜像：戳这里

下载完成后，直接打开dmg文件安装，不需要进行任何修改。
安装完成后，打开Terminal，输入

latex -version

显示上图信息，则说明安装成功。然后再输入

echo $PATH

检查是否有texlive的相关路径（mactex安装包所对应的应用程序）如下图：

如果没有，重启电脑试试，（我刚安装完的时候就没有）
如果再没有，就在 ~/.bash_profile 里添加

export PATH=$PATH:/Library/TeX/texbin

然后在terminal输入

. ~/.bash_profile

刷新下环境。

下载Skim 阅读器

skim 是pdf阅读器，便于我们使用latex编写完后可以直接编译看到 pdf 的内容。
官网下载地址：戳这里
其他下载地址：戳这里 戳这里

vscode 中下载 LaTeX Workshop 插件

在 Extensions 里 下载 LaTeX Workshop。下载完成后，就会出现如下图第四步里所示的图标。

配置vscode 环境

使用 “ command + shift + P ” 打开命令行, 输入 “ open user settings” 显示下图

点击含（JSON）项，在大括号里 加入 以下内容 （注意不要覆盖其他内容）：

    // LaTeX
    // 不在保存的时候自动编译
    "latex-workshop.latex.autoBuild.run": "never",
    // 编译工具
    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "%DOCFILE%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
  // 编译命令
    "latex-workshop.latex.recipes": [
        {
            "name": "pdflatex",// 不含参考目录 bibtex
            "tools": [
              "pdflatex"
            ]
          },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2", // 含参考目录 bibtex
            "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",  
        "*.nav",  
        "*.snm",  
        "*.synctex.gz"  
    ],

测试

然后可以在项目里新建一个demo.tex文件，复制粘贴一下代码

\documentclass{article}
\begin{document}
Hello, euzmin!
\end{document}

执行如下图操作：

说明安装成功，可以愉快的写latex了。
另外如果需要编译含bibtex的内容，可以在第2步点击下面那个recipe。

参考

https://www.jianshu.com/p/6f2e385c6653
https://liam.page/texlive/