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

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

相關推薦：《vscode基礎教學》

Visual Studio Code （以下簡稱VS Code）是微軟推出的一款編輯器，在嘗試為用他配置Python 開發環境之後，我深深的被VS Code的代碼高亮和中文顯示吸引了，以至於用了這麼多年的Sublime Text 都想遷移到VS Code，搭建好LaTeX環境之後，我對比了下Sublime Text 和VS Code，感覺Sublime Text 這塊更成熟（特別指LaTeX），VS Code 屬於追趕者，用過之後覺得還是很不錯的~~

基本需求

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

軟體的安裝

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

外掛程式的安裝

在安裝Visual Studio Code 之後，在左側開啟擴充功能（快速鍵<span style="font-size:14px">Ctrl Shift X</span> ），搜尋LaTeX Workshop，選擇安裝，並選擇重啟VS Code 啟用插件。

兩種編譯方式

使用可變TeX 引擎

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

將這個檔案儲存為<span style="font-size:14px">test.tex</span>，然後使用快捷鍵 <span style="font-size:14px">Ctrl Alt B</span> 編譯，或是在文件中，滑鼠右鍵，選擇Build LaTeX Project，這樣就能使用 <span style="font-size:14px">xelatex</span> 編譯<span style="font-size:14px">test.tex</span> 了。

其實，LaTeX Workshop 預設的編譯方式是<span style="font-size:14px">latexmk</span>，我們還可以仿造MiKTeX 裡面的TeXify 指令，只需要將設定修改為

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

指定編譯方式

修改外掛設定檔

說到指定單獨的編譯方式，這裡還是有兩個不同的方式，一種是在上述的設定基礎上繼續修改，可以將<span style="font-size:14px">command</span>修改為<span style="font-size:14px">xelatex</span>或<span style="font-size:14px">pdflatex</span>以及<span style="font-size:14px"></span>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 中，并为这个项目配置 <span style="font-size:14px">tasks.json</span> 文件，在 <span style="font-size:14px">tasks.json</span> 文件中指定编译方式等。

具体操作是，在任务栏选择 任务->运行任务，然后 VS Code 会提示没有任务，需要配置任务，然后选择使用模板创建任务，在模板选择的时候，选择 MS.build 就行。然后将 <span style="font-size:14px">tasks.json</span>文件内容修改为（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 文件，适用于大型项目，比如论文，笔记或者书籍等（推荐）。并且只要你配置好 <span style="font-size:14px">tasks.json</span>文件之后，以后打开文件就不用管编译方式和配置了，可以直接运行任务就行。

其他设置

修改快捷键

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

反向定位跳转

通过右侧的红色 PDF 按钮，我们可以打开 PDF 预览，我们在查看 PDF 的时候，可以通过快捷键 <span style="font-size:14px">Ctrl+Shift+Left</span>跳转到代码。

更多编程相关知识，请访问：编程教学！！

以上是淺談VSCode搭建 LaTeX 編寫環境的方法的詳細內容。更多資訊請關注PHP中文網其他相關文章！