引言

参考视频：

1. 发SCI必备的【LaTex】使用教程（第二期）

1. 设置 Vscode 编辑器格式

配置代码决定了如何在 Vscode 中编译 Latex 代码。

  // 当设置为"never"时，禁用了保存LaTeX文档时自动编译的功能。
  "latex-workshop.latex.autoBuild.run": "never",
  
  // 启用VS Code编辑器中的LaTeX文件右键菜单。
  "latex-workshop.showContextMenu": true,
  
  // 启用LaTeX Workshop的智能感知功能，包括代码自动完成、参数信息等。
  "latex-workshop.intellisense.package.enabled": true,
  
  // 禁用错误信息在编辑器中的显示。
  "latex-workshop.message.error.show": false,
  
  // 禁用警告信息在编辑器中的显示。
  "latex-workshop.message.warning.show": false,

2. 定义 Latex 编译工具的配置

xelatex 提供 Unicode 支持。

Unicode 是一种国际标准.为所有字符提供唯一的数字标识，适合处理复杂的文本和字体。

  // 定义了LaTeX编译工具的配置，包括工具名称、命令和参数。
  "latex-workshop.latex.tools": [
    {
      "name": "xelatex", // 工具名称：xelatex
      "command": "xelatex", // 执行的命令
      "args": [ // 命令参数
        "-synctex=1", // 启用同步TeX，方便在PDF和源文件之间跳转
        "-interaction=nonstopmode", // 设置为非停止模式，编译时不中断
        "-file-line-error", // 显示错误的文件名和行号
        "%DOCFILE%" // 代表当前文档的路径
      ]
    },

pdflatex 和传统的 Latex 宏包和文档类有很好的兼容性，适合处理大多数英文文档。

    {
      "name": "pdflatex", // 工具名称：pdflatex
      "command": "pdflatex",
      "args": [ // 命令参数，与xelatex类似
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOCFILE%"
      ]
    },

latexmk 用来实现自动化编译 Latex 文档。

    {
      "name": "latexmk", // 工具名称：latexmk
      "command": "latexmk",
      "args": [ // 命令参数，latexmk特有的参数
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "-pdf", // 生成PDF输出
        "-outdir=%OUTDIR%", // 输出目录，%OUTDIR%为占位符
        "%DOCFILE%"
      ]
    },

bibtex 用来处理 Latex 文档中的参考文献

    {
      "name": "bibtex", // 工具名称：bibtex
      "command": "bibtex",
      "args": [ // 命令参数
        "%DOCFILE%" // 代表当前文档的路径，用于处理参考文献
      ]
    }
  ]

3. 设置编译链

如果文档既涉及中文，又涉及英文，还涉及参考文献，就需要多次编译，编译链就是用来解决该问题的工具。

// 定义了LaTeX编译流程的名称和使用的编译工具序列。
  "latex-workshop.latex.recipes": [
    {
      "name": "XeLaTeX", // 编译流程名称：单独使用XeLaTeX
      "tools": ["xelatex"] // 使用的工具
    },
    {
      "name": "PDFLaTeX", // 编译流程名称：单独使用PDFLaTeX
      "tools": ["pdflatex"]
    },
    {
      "name": "BibTeX", // 编译流程名称：单独使用BibTeX
      "tools": ["bibtex"]
    },
    {
      "name": "LaTeXmk", // 编译流程名称：使用latexmk
      "tools": ["latexmk"]
    },
    {
      "name": "xelatex -> bibtex -> xelatex*2", // 编译流程名称：xelatex + bibtex + 两次xelatex
      "tools": ["xelatex", "bibtex", "xelatex", "xelatex"]
    },
    {
      "name": "pdflatex -> bibtex -> pdflatex*2", // 编译流程名称：pdflatex + bibtex + 两次pdflatex
      "tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]
    }
  ],

4. 清除多余文件

 // 定义了编译过程中生成的临时文件类型，这些文件在清理时会被删除。
  "latex-workshop.latex.clean.fileTypes": [
    "*.aux", "*.bbl", "*.blg", "*.idx", "*.ind", "*.lof", "*.lot",
    "*.out", "*.toc", "*.acn", "*.acr", "*.alg", "*.glg", "*.gls",
    "*.glo", "*.ist", "*.fls", "*.log", "*.fdb_latexmk"
    // 这些文件类型包含了LaTeX编译过程中生成的各种辅助文件
  ],

  // 设置在编译失败时自动清理临时文件。
  "latex-workshop.latex.autoClean.run": "onFailed",
  
  // 设置默认使用上次使用的编译流程。
  "latex-workshop.latex.recipe.default": "lastUsed",
  
  // 设置PDF查看器中同步TeX的快捷键为双击。
  "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click"