LaTeX入门（2）：快速搭建一个AI辅助写作环境

前言

本文基于VS Code与Docker实现一键配置LaTeX开发环境，我发布了一个相对精简的中文支持镜像laotie255/texlive-zh。

此外还集成了豆包AI，实现AI辅助写作的能力。

VS Code

VSCode是微软出品，被广泛使用的一个代码编辑器。LaTeX作为一种标记语言，编辑逻辑与其他代码的编辑完全一致。使用VSCode可支持语法高亮，语法提示，版本控制等功能，丝毫不逊色于专门的LaTeX编辑器。并且对已经熟悉VSCode使用的朋友来说，更是无缝切换。

Docker

Docker可以用来启动一个容器，一个容器可以理解成一个虚拟机，我们用Docker，把LaTeX编译环境打包在容器里面，免去了大部分开发和配置的工作，是一个开箱即用的环境，而且用完可以随时删除不在宿主机残留痕迹。

豆包AI

豆包MarsCode（www.MarsCode.cn/home）是基于字节跳动豆包大模型打造的更智能、更便捷的开发工具，提供 Cloud IDE 及 AI 编程助手两种使用形态。

作为豆包代码模型的具体应用，豆包MarsCode 支持智能识别当前编码任务相关的上下文信息，同时将代码理解、生成、优化、推荐、补全、审查等多维能力融为一体，无缝嵌入研发流程的各个环节，帮助开发者提升代码开发质量和效率。

LaTeX Workshop

LaTeX Workshop是VS Code上使用最多的一个LaTeX插件，支持代码格式化，动态编译，实时预览等功能

环境搭建方法

LaTeX Workshop 支持两种方式使用Docker镜像，一种是Dev Container，这是被官方推荐的方式。另一种是可执行容器，即仅仅把容器当作一个普通的命令行程序来使用，虽然官方不建议这种方式，但这种方式依然有其优点。我们会在后面展开介绍。

下面两种搭建方法任选其一即可。

1. Dev Container

开发环境容器，也就是把容器当作虚拟机，直接在虚拟机编写和编译，但是所有的文件会映射在宿主机。

优点：官方推荐，相当于在一个Debian的虚拟机操作，方便对环境做变更，比如需要安装新的宏包，直接在命令行执行即可。
缺点：如果容器被误删，所有在容器里面的变更会丢失。与宿主机隔离，使得许多信息共享出问题，比如git的身份认证信息。一些插件运行在容器里面会报错，比如Mars Code。

创建配置

在你的代码根目录创建如下路径文件.devcontainer/devcontainer.json，如果没有.devcontainer文件夹请自行创建，文件内容如下：

{
    "name": "TeX Live",
    "dockerFile": "Dockerfile",
    "customizations": {
        "vscode": {
            "extensions": [
                "james-yu.latex-workshop",
                "MarsCode.marscode-extension"
            ]
        }
    }
}

再创建文件.devcontainer/Dockerfile，内容如下

FROM laotie255/texlive-zh:latest

devcontainer.json里面定义了镜像的Dockerfile，以及开发容器里面需要的两个插件，LaTeX Workshop 和 Mars Code。

Dockerfile定义了镜像的构建方式，默认情况下，我们直接使用laotie255/texlive-zh:latest即可，如果这个镜像中缺少了宏包或者其他组件，我们可以在 Dockerfile 中添加这部分的安装过程。

接下来创建本地配置文件.vscode/settings.json，如果没有.vscode文件夹请自己创建，文件内容如下：

{
    "latex-workshop.latex.recipes": [
        {
            "name": "latexmk (xelatex)",
            "tools": [
                "xelatexmk"
            ]
        }
    ],
    "[latex]": {
        "editor.defaultFormatter": "James-Yu.latex-workshop"
    },
    "latex-workshop.latex.autoClean.run": "onBuilt"
}

进入容器

先确保docker服务已经启动。如下图所示在VS Code点击左下角><图标，选择Reopen in Container。

耐心等待容器构建成功，第一次要下载的东西比较多会比较慢，后面会很快。看到><图标显示Dev Container: Tex Live即表示已进入容器环境，至此便成功构建了一个容器开发环境。

2. 可执行容器

可执行容器与前面的 Dev Container 的区别是，编辑过程全部都在宿主机，只有编译的时候启动容器来编译，完成之后即销毁容器。这种方式下我们不用在宿主机安装Tex Live，依然可以有宿主机操作的丝滑感。

优点：完全是本地操作，git与各种插件不会出现水土不服。镜像定义清晰，不会丢配置。
缺点：容器镜像的变更麻烦，如果要增加宏包或者安装其他工具，都需要重新构建镜像。更高门槛。

创建本地配置文件.vscode/settings.json。

主要是增加了latex-workshop.docker.enabled和latex-workshop.docker.image.latex两个配置。

{
    "latex-workshop.docker.enabled": true,
    "latex-workshop.docker.image.latex": "laotie255/texlive-zh:latest",
    "latex-workshop.latex.recipes": [
        {
            "name": "latexmk (xelatex)",
            "tools": [
                "xelatexmk"
            ]
        }
    ],
    "[latex]": {
        "editor.defaultFormatter": "James-Yu.latex-workshop"
    },
    "latex-workshop.latex.autoClean.run": "onBuilt"
}

使用方法

至此我们完成了环境的配置，接下来说说使用方法。

编译和查错

默认是保存tex文件时即会启动编译流程，如果失败报错，在TEX插件中查看错误日志，可以把错误日志发给豆包AI提供解决方法。

编译完成之后，会生成 pdf 文件，可以用分栏视图查看源代码和目标 pdf，这样每次保存之后，马上可以看到 pdf 的更新情况。

AI能力

AI能力由豆包MarsCode提供。MarsCode 基于字节跳动的豆包 AI 的能力，可以使 LaTeX 的写作门槛更低。

自动完善

基本不用人工介入，在写作过程中Mars Code会自动帮你做提示和完善。也可以通过注释来提示AI帮你补写，如果你认为完善的内容可以采纳，按tab键即可输入。如下：

AI对话

可以在代码中选定上下文，就选中内容与AI展开对话。比如选中一段话，让AI帮你改写或者提出优化意见。

AI 对话支持的能力包括但不仅限于：

错误排查
询问语法和公式
代码片段的生成
其他知识的获取

公式编写能力

LaTeX 的作者中大部分都是理工科，难免有公式编辑的需求，我们可以用其他语言（比如 Python）来实现一个公式，然后让 AI 把它转换成 LaTeX 公式。

在具有多模态的大模型上，我们甚至可以发手写公式的截图给 AI，让他生成 LaTeX 的公式代码，根据我的测试，这个方法在 GPT-4o 上准确度极高。

小结

使用 VS Code 和容器技术可以更方便的搭建 LaTeX 的编辑环境，同时利用 VS Code 与 AI 插件的集成能力，也可以简单拥有一个免费的 AI 写作助手。

利用好 AI，会使得我们编写 LaTeX 的门槛大大降低，我庆幸生活在这样的一个时代。

前言