淺談VSCode搭建 LaTeX 編寫環境的方法-VSCode-PHP中文網

本篇文章跟大家介紹VSCode建置 LaTeX 寫環境的方法。有一定的參考價值，有需要的朋友可以參考一下，希望對大家有幫助。

淺談VSCode搭建 LaTeX 編寫環境的方法

基本需求

TeXlive 或MiKTeX （本文以TeXlive 2015 為例）
Visual Studio Code
#LaTeX Workshop （VS Code 插件)

軟體的安裝

TeXlive 和Visual Studio Code 的安裝這裡不贅述，需要注意的一個事情是，安裝之後需要將TeXlive 的bin 目錄（C:\texlive\2015\bin\win32）加入系統的環境變數（PATH）中。

外掛程式的安裝

在安裝Visual Studio Code 之後，在左側開啟擴充功能（快速鍵Ctrl Shift X ），搜尋LaTeX Workshop，選擇安裝，並選擇重啟VS Code 啟用插件。

兩種編譯方式

使用可變TeX 引擎

在我們寫LaTeX 文件的時候，有兩個指令很特殊，一個是 %!TEX program = xelatex，一個是% !TEX root = relative/or/absolute/path/to/root/file.tex#，前者指定編譯方式，後者指定主（根）文件，借助這個，我們可以對不同文檔設定不同的編譯方式，這就簡化了編譯時的麻煩。如果我們指定了文檔的編譯方式，則只需要按照下面配置就可以編譯 LaTeX 文件了。

具體做法是，在VS Code 左下角，點擊齒輪圖案的按鈕，選擇設置，在右側添加LaTeX Workshop 的配置命令

  "latex-workshop.latex.clean.enabled": false,
    "latex-workshop.view.pdf.hand": true,
    // 可变编译方式 
    "latex-workshop.latex.toolchain": [
      {
        "command": "", // 注意这里是留空的
        "args": [
          "-synctex=1",
          "-interaction=nonstopmode",
          "-file-line-error",
          "%DOC%"
        ]
      }
    ],

登入後複製

然後我們選擇新建一個文件（前幾天看到兩位部落客借鏡我們2014 年Sublime Text 搭建LaTeX 寫環境部落格的內容，連下面的程式碼都是一樣的，但是在文中卻沒有引用我們的，呵呵呵），鑑於此，我決定加入一些個人資訊。

%!TEX program = xelatex
% 使用 ctexart 文类，UTF-8 编码
\documentclass[UTF8]{ctexart}
\title{测试}
\author{ddswhu}
\date{\today}

\begin{document}
\maketitle

This is the context of the article.

这就是文章的所有内容。

\end{document}

登入後複製

將這個檔案儲存為test.tex，然後使用快捷鍵 Ctrl Alt B 編譯，或是在文件中，滑鼠右鍵，選擇Build LaTeX Project，這樣就能使用 xelatex 編譯test.tex 了。

其實，LaTeX Workshop 預設的編譯方式是latexmk，我們還可以仿造MiKTeX 裡面的TeXify 指令，只需要將設定修改為

"latex-workshop.latex.toolchain": [
  {
    "command": "texify",
    "args": [
      "--synctex",
      "--pdf",
      "--tex-option=\"-interaction=nonstopmode\"",
      "--tex-option=\"-file-line-error\"",
      "%DOC%.tex"
    ]
  }
]

登入後複製

指定編譯方式

修改外掛設定檔

說到指定單獨的編譯方式，這裡還是有兩個不同的方式，一種是在上述的設定基礎上繼續修改，可以將command修改為xelatex或pdflatex以及bibtex

。

以下是一個完整的PDFLaTeX 編譯（pdflatex->bibtex->pdflatex->pdflatex）

"latex-workshop.latex.toolchain": [
  {
    "command": "pdflatex",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "%DOC%"
    ]
  }, {
    "command": "bibtex",
    "args": [
      "%DOCFILE%"
    ]
  }, {
    "command": "pdflatex",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "%DOC%"
    ]
  }, {
    "command": "pdflatex",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "%DOC%"
    ]
  }
]

登入後複製

因為這裡指定了具體的編譯方式，所以在文檔部分不需要指定編譯方式。由於設定檔是全域的，所以這種方式對於不同文件，你需要臨時設定文件，有點不太方便。 ######

修改项目任务文件

在 VS Code 中，在操作时并不是以单个文件为依托，而是以项目或者工程为单位。对应的，在 VS Code，我们需要将这个文件夹导入到 VS Code 中，并为这个项目配置 tasks.json 文件，在 tasks.json 文件中指定编译方式等。

具体操作是，在任务栏选择任务->运行任务，然后 VS Code 会提示没有任务，需要配置任务，然后选择使用模板创建任务，在模板选择的时候，选择 MS.build 就行。然后将 tasks.json文件内容修改为（filename 替换为你需要编译的文件名（主文档））。

{
    "version": "0.1.0",
    "isShellCommand": true,
    "suppressTaskName": true,
    "tasks": [{
            "taskName": "PDFLaTeX",
            "command": "pdflatex",
            "isBuildCommand": true,
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "filename.tex"
            ]}, {
            "taskName": "BibTeX",
            "command": "bibtex",
            "isTestCommand": true,
            "args": ["filename.aux"]
            },
           {
            "taskName": "XeLaTeX",
            "command": "xelatex",
            "isBuildCommand": true,
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "filename.tex"
            ]},
        ]
}

登入後複製

这样，任务配置好了，接下来就只要运行就行了。依次选择任务->运行任务，选择你所需要的编译方式，如果需要完整编译，假设文档有 bib 文件，则需要选择 PDFLaTeX->BibTeX->PDFLaTeX->PDFLaTeX，这种配置的好处是，你可以完全控制编译方式，能选择编译 bib 文件，适用于大型项目，比如论文，笔记或者书籍等（推荐）。并且只要你配置好 tasks.json文件之后，以后打开文件就不用管编译方式和配置了，可以直接运行任务就行。

其他设置

修改快捷键

编译的默认快捷键是 Ctrl+Alt+B，由于我习惯了 Sublime Text 的 Ctrl+B，所以这里我们再提一下 VS Code 快捷键的设置，在 VS Code 左下角，点击齿轮图案的按钮，选择键盘快捷方式，然后再搜索栏里面选择 LaTeX Workshop，将第一个 Build LaTeX Project 的快捷键修改为 Ctrl+B 即可。