VSCode+texlive搭建LaTeX写作环境

浅浅的花香味﹌ 2023-01-03 11:28 418阅读 0赞

### texlive安装 ###

可通过[官网][Link 1]、[华为云][Link 2]或者[阿里云][Link 3]下载安装包，下载之后直接安装即可，当然也可以按照文末给的方法把不必要的语言包勾掉以节省大概1G的空间，本人嫌麻烦就没搞哈哈哈。

### VSCode上安装LaTeX插件 ###

在插件商店中搜索"LaTeX Workshop"插件并安装。

### 配置VSCode的LaTeX插件 ###

##### 编译生成pdf文件 #####

在VSCode界面中按F1键入"setjson"之后打开"Preferences: Open Settings(JSON)"

这里本人写论文一般会用"pdflatex"做为编译器，而且一般需要编译两次才能正常显示应用的文章编号，因此本人做了如上的设置，如果需要用到"xelatex"等别的编译器，只需要做对应修改即可，参考文章中同样给出了具体的操作。

如果文献是用bib文件进行处理的，那么代码修改如下：

{
        
        "latex-workshop.latex.tools": [
            {
        
                // 编译工具和命令
                "name": "pdflatex",
                "command": "pdflatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOCFILE%"
                ]
            },
            {
        
                "name": "bibtex",
                "command": "bibtex",
                "args": [
                    "%DOCFILE%"
                ]
            }
        ],
        "latex-workshop.latex.recipes": [
            {
        
                "name": "pdf->bib->pdf->pdf",
                "tools": [
                    "pdflatex",
                    "bibtex",
                    "pdflatex",
                    "pdflatex",
                ]
            },
            {
        
                "name": "xe->bib->xe->xe",
                "tools": [
                    "xelatex",
                    "bibtex",
                    "xelatex",
                    "xelatex"
                ]
            },
        ],
    }

这里要注意最后要用pdflatex编译两次引用论文才能正常显示。

完成上面的设置就可以直接在VSCode的TEX选项中点击进行编译了和查看生成的PDF了，快捷方式为"Ctrl+Alt+B"。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29IYW5UYW5ZYW5ZaW5n_size_16_color_FFFFFF_t_70]

### 在VSCode中使用Sumatra PDF预览PDF并与tex文件进行交互 ###

##### 使用Sumatra PDF对PDF进行预览 #####

虽然VSCode可以直接提供pdf的预览，然而其功能还没有Sumatra PDF那么强大，为了实现与tex文件的联动，我们使用Sumatra PDF来进行预览。当然如果后面有老哥发现VSCode自动的那些pdf浏览工具也可以有相同的操作麻烦留言指点本人一下，不胜感激！

先下载并安装[Sumatra PDF][]，然后在之前的设置文件中添加如下的代码：

"latex-workshop.view.pdf.external.viewer.command": "C:/software/SumatraPDF/SumatraPDF.exe",
        "latex-workshop.view.pdf.external.viewer.args": [
            "-forward-search",
            "%TEX%",
            "%LINE%",
            "-reuse-instance",
            "-inverse-search",
            "\"C:/Users/用户名/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \"C:/Users/用户名/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
            "%PDF%"
        ],

上面的路径要换成自己的，本人默认安装的vscode，位置可供参考。完成上面的配置就可以直接用VSCode来打开Sumatra PDF进行预览了。

##### 配置正向和反向搜索 #####

下面就是重点了，也是用这整套东西最核心的部分，那就是正向和反向搜索，用LaTeX写过文章的老哥一定十分清楚这两项东西的重要性！

首先是正向搜索，将如下代码添加进配置文件即可：

"latex-workshop.view.pdf.external.synctex.command": "C:/software/SumatraPDF/SumatraPDF.exe",
    "latex-workshop.view.pdf.external.synctex.args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        "-inverse-search",
        "\"C:/Users/用户名/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \"C:/Users/用户名/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
        "%PDF%",
    ],

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29IYW5UYW5ZYW5ZaW5n_size_16_color_FFFFFF_t_70 1]

这样点击"SyncTeX from cursor"就可以进行正向搜索了。

接着反向搜索，这在改论文的时候非常重要。本人在要按照参考文章进行设置的时候发现该Sumatra PDF已经自己设置好了，可能是版本更新的缘故，现在无需自行配置了(前提应该是你安装Sumatra PDF之前就安装了VSCode)

### 在VSCode中使用配置快捷键 ###

上面的操作虽然已经非常方便了，但有键盘的情景下快捷键永远是真理，因此我们可以将操作全部设置成快捷键。

操作是在VSCode界面中按F1键入"keyjson"之后点击"Preferences: Open Keyborad Shortcuts(JSON)"，在keybindings.json文件中写入如下代码：

{
        
        "key": "alt+s",
        "command": "latex-workshop.synctex",
        "when": "editorTextFocus && !isMac"
    },
    {
        
        "key": "alt+b",
        "command": "latex-workshop.build",
        "when": "editorTextFocus && !isMac"
    },
    {
        
        "key": "alt+t",
        "command": "latex-workshop.kill",
        "when": "editorTextFocus && !isMac"
    },

将"Alt+S"绑定到正向搜索，将"Alt+B"绑定到使用默认recipe编译，将"Alt+T"绑定到终止编译。

### 取消保存前编译 ###

LaTeX Workshop 默认保存的时候自动编译，如果不喜欢这个设置，可以添加以下代码进入设置文件：

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

到此所有配置的东西就全部完成了，配置文件的全部代码如下：

{
        
        "latex-workshop.latex.tools": [
            {
        
                // 编译工具和命令
                "name": "pdflatex",
                "command": "pdflatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "%DOCFILE%"
                ]
                
            },
            {
        
                // 编译工具和命令
                "name": "xelatex",
                "command": "xelatex",
                "args": [
                    "-synctex=1",
                    "-interaction=nonstopmode",
                    "-file-line-error",
                    "-pdf",
                    "%DOCFILE%"
                ]
            },
            {
        
                "name": "bibtex",
                "command": "bibtex",
                "args": [
                    "%DOCFILE%"
                ]
            }
        ],
        "latex-workshop.latex.recipes": [
            {
        
                "name": "pdf->bib->pdf->pdf",
                "tools": [
                    "pdflatex",
                    "bibtex",
                    "pdflatex",
                    "pdflatex",
                ]
            },
            {
        
                "name": "xe->bib->xe->xe",
                "tools": [
                    "xelatex",
                    "bibtex",
                    "xelatex",
                    "xelatex"
                ]
            },
        ],
        "latex-workshop.view.pdf.viewer": "external",
    
        "latex-workshop.view.pdf.external.viewer.command": "C:/software/SumatraPDF/SumatraPDF.exe",
        "latex-workshop.view.pdf.external.viewer.args": [
            "-forward-search",
            "%TEX%",
            "%LINE%",
            "-reuse-instance",
            "-inverse-search",
            "\"C:/Users/weixinhum\/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \"C:/Users/weixinhum\/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
            "%PDF%"
        ],
        "latex-workshop.view.pdf.external.synctex.command": "C:/software/SumatraPDF/SumatraPDF.exe",
        "latex-workshop.view.pdf.external.synctex.args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "-reuse-instance",
        "-inverse-search",
        "\"C:/Users/weixinhum\/AppData/Local/Programs/Microsoft VS Code/Code.exe\" \"C:/Users/weixinhum\/AppData/Local/Programs/Microsoft VS Code/resources/app/out/cli.js\" -gr \"%f\":\"%l\"",
        "%PDF%",
        ],
        "latex-workshop.latex.autoBuild.run": "never",
        "tabnine.experimentalAutoImports": true,
        "window.zoomLevel": 1,
        "editor.wordWrap": "on",
    }

最后感谢下下面参考的这篇文章，本文基本是按照作者的文章操作完成的，本人所做的工作主要是将个人认为不必要的地方删减了。如发现有雷同绝非巧合！感谢下面文章的作者已经帮助该作者改善错误的众多老哥！

### 参考文章： ###

https://zhuanlan.zhihu.com/p/38178015

[Link 1]: https://www.tug.org/texlive/acquire-netinstall.html
[Link 2]: https://mirrors.huaweicloud.com/CTAN/systems/texlive/Images/
[Link 3]: https://mirrors.aliyun.com/CTAN/systems/texlive/Images/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29IYW5UYW5ZYW5ZaW5n_size_16_color_FFFFFF_t_70]: /images/20221119/31568370a3f546beb6c40b7080e026c7.png
[Sumatra PDF]: https://www.sumatrapdfreader.org/download-free-pdf-viewer.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L29IYW5UYW5ZYW5ZaW5n_size_16_color_FFFFFF_t_70 1]: /images/20221119/47e4ea1ae3d64ae89876af2b7897fbd2.png