linux latex vscode

### 配置 VSCode 在 Linux 下编辑 LaTeX 文档

#### 安装必要的软件包
为了能够在 Linux 上通过 Visual Studio Code (VSCode) 编辑 LaTeX 文件，需要安装一些必需的软件包。对于大多数基于 Debian 的发行版来说，可以通过以下命令来完成 TeX Live 和其他依赖项的安装[^1]：

sudo apt-get update && sudo apt-get install texlive-full

这一步骤确保了系统拥有完整的 LaTeX 发行版本以及所有可能需要用到的功能。

#### 安装 VSCode 及其扩展插件
下载并安装最新版本的 Visual Studio Code 后，在应用内打开 Extensions 视图 (`Ctrl+Shift+X`) 并搜索 `LaTeX Workshop` 插件进行安装。此插件提供了对 LaTeX 项目的支持，包括语法高亮显示、自动补全等功能[^2]。

#### 设置工作区配置文件
创建一个新的 `.vscode/settings.json` 文件于项目的根目录下，并加入如下内容以便更好地管理构建过程和路径设置:

{
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "%DOC%"
            ],
            "env": {}
        }
    ]
}

上述 JSON 片段定义了一个名为 `latexmk` 工具条目用于处理 PDF 输出；同时指定了若干参数以优化用户体验[^3]。

#### 解决初次编译错误
当首次尝试编译时遇到类似于 `"Recipe terminated with fatal error: spawn latexmk ENOENT"` 错误提示，则可能是由于环境变量未被正确加载所致。此时可采取措施之一便是利用 Remote-SSH 功能关闭远端主机上的 VSCode Server 实例后再试一次编译流程。具体做法是在 VSCode 中按下 F1 调出命令面板，接着输入 `Remote-SSH: Kill VS Code Server on Host...` 来执行相应操作。