VScode的使用

VScode的使用

摘要：主要内容包括：VScode的配置、LaTeX的相关配置。

---

---

前言

主要内容包括：VScode的配置、LaTeX的相关配置。

---

一、VScdoe的一般配置

1. 自动换行

当一行长文本无法完全显示时，可设置为自动换行

"editor.wordWrap": "on"

二、使用LaTeX的配置

1. LaTeX Workshop 插件

在VScdoe 扩展 (Extensions) 中搜索“LaTeX Workshop”，之后点击安装即可。

2. VScode 中的设置

打开VScdoe，按F1键，输入 settings.json，点击“Open User Settings”进入编辑文件页面，添加以下内容到已有的花括号内并保存，各设置行尾用逗号与后面的隔开，最后一行不用逗号。

 "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%"
            ]
        },
        {
        "name": "biber",
        "command": "biber",
        "args": [
            "%DOCFILE%"
        ]
        }
    ],
    // 设置编译方法
    "latex-workshop.latex.recipes": [
        {
            "name": "xelatex",
            "tools": [
                "xelatex"
            ],
        },
        {
            "name": "pdflatex",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "xe->biber->xe->xe",
            "tools": [
                "xelatex",
                "biber",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdf->biber->pdf->pdf",
            "tools": [
                "pdflatex",
                "biber",
                "pdflatex",
                "pdflatex"
            ]
        }
    ]

注意：新版BibLaTeX默认用Biber而非BibTeX来处理参考文献，设置编译方法(recipes)时，用biber,即 “xe->biber->xe->xe” 而非 “xe->bibtex->xe->xe”。否则编译含参考文献的tex文件时，可能出现 “I found no \citation commands” 的错误信息。可根据实际情况酌情选择。

其他设置：

1. 设置保存时不自动编译

LaTeX Workshop 默认保存时自动编译，若取消，可添加以下代码至settings.json文件：

"latex-workshop.latex.autoBuild.run": "never"

2. 删除编译时产生的中间文件

  "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"
  ],

注：建议保留.aux、.bbl、.out等文件，用xelatex编译，速度会比较快。若删除前面三类文件，则无法单独使用xelatex进行编译。

3. 正/反向搜索

正向搜索：编辑器中光标所在源码处，按ctrl+alt+J定位到pdf文件对应位置。
反向搜索：在pdf文件中鼠标双击，可定位到对应的latex源码处，方便查找。

参考资料

1. 星水天河，一文解决VScode配置Latex，https://blog.csdn.net/weixin_44509533/article/details/129348215
2. LaTeX 编译后pdf外部浏览器设置方法参见：https://zhuanlan.zhihu.com/p/166523064