LaTeX + VSCode + Git 开发环境搭建

是一个排版软件，而则提供了一个极为丰富的宏集，让人们不需要费心构建费心钻研排版效果，而专注于文本的编写。对于像IEEE这样会提供论文的模板的出版社，撰写论文变得更加简单。TeXLive则是软件的其中一个广为人知的发行版。

而多个作者同时编辑一篇论文时，协同工作尤为必要。相对于微软对Word提供了协同工作的技术，其实的协同工作更为简单，因为文档由代码编译而成，所有的源文件都是文本文件，那么一个Git仓库就可以解决问题。

VSCode在这篇文章中出现是因为，个人没有发现的GUI编辑器们有谁长得好看。以及，配合插件使用，使用VSCode编写文档是一件很舒服的事情。

本篇文章只带领简单入门，保证可用，但更深入的内容本篇不予赘述。

TeXLive的下载安装

镜像下载

TeXLive官网默认的安装方式是使用在线安装包，这对于国内实在太慢了，所以建议下载光盘镜像文件离线安装。

下载页面

安装

挂载iso镜像为虚拟光驱（Win10双击iso文件即可，Win7之前的版本需要借助软件），然后使用管理员权限运行根目录下的批处理文件install-tl-advanced.bat，在弹出窗口中点击Continue，配置好安装路径后点击安装TeXLive，接下来进入漫长的等待。取决于机器配置，每个人耗费的时间可能有所不同，我本人安装了半个多小时。不过在TeXLive安装完成之前，我们可以先将VSCode与Git安装完成。

TeXLive安装

VSCode与Git下载安装

VSCode安装包下载请至官网。

Git安装包下载请至官网。

Git安装完成后，在命令行中输入git命令执行，查看是否成功返回Git的帮助信息：

Git安装完成

配置VSCode

所有软件安装完成后，打开VSCode，搜索插件LaTeX，安装后重新载入，使插件生效。

LaTeX Workshop

添加插件LaTeX Workshop支持的“魔法注释”

对于一个项目，需要指定编译工具链才能正确地被编译成pdf文档。配合插件LaTeX Workshop使用，如下设置可实现编译链pdflatex -> bibtex -> pdflatex*2：

在主tex文件开头添加如下两行注释指定编译工具：

% !TEX program = pdflatex

% !BIB program = bibtex

在非主tex文件首行添加如下设置指定主tex文件的位置：

% !TEX root = 主tex文件绝对/相对路径

在VSCode中执行命令编译

按下Ctrl + Shift + P，弹出VSCode的命令输入框，输入latex后找到命令Build LaTeX Project，执行后会看到左下角的编译动态以及VSCode的输出窗口中的编译日志。

LaTeX编译

编译完成后，即可在VSCode中预览编译生成的pdf文件，并且编辑tex文件后随时保存，就会触发重新编译生成新的pdf文档。打开预览窗口的方式有两种，一是点击tex文件编辑窗口右上角的第二个带有放大镜的按钮，二是使用命令的方式，如下图：

LaTeX预览

一切顺利的话，你就可以看到完整的pdf文档了。

Git的简单使用

对于Git新手，也许一个图形化界面更为方便。当然，还是强烈建议阅读文档，或者廖雪峰老师的Git教程。对于Windows平台的图形化界面，Github Desktop是一个不错的选择。下载安装后，点击首页的Clone a respository按钮，输入项目的url（可以在项目的托管网站的主页找到）和想要保存的本地路径，就可以将远程项目克隆到本地。如果需要权限，会弹出窗口要求输入账号密码。

克隆项目

克隆完成后，可以在界面上方选择自己的分支：

切换分支

在对项目进行修改后，需要通过commit操作来提交修改（必须要有一段文字描述代码的改动，可以随便写。为了别人能够容易地读懂，可参照Commit 编写规范）：

commit

然后通过push操作推送代码至远程服务器（可通过在 Github Desktop 中点击Push origin）：

push

最后，如果要把代码推送到master分支的话，需要新建一个合并请求（pull request），这个可以直接在托管平台的网页上进行，以Coding.net（或腾讯云开发者平台）为例，点击项目主页的新建合并请求，选择需要合并的分支和被合并入的分支，提交请求等待管理员接受：

pull request

当然，VSCode内置的Git插件支持这所有的操作，命令行更不必说。记得打开项目时先将master分支合并到自己编辑的分支。