vscode latexmk

### 配置和使用 Latexmk 进行 LaTeX 编译 为了在 Visual Studio Code (VSCode) 中配置并使用 `latexmk` 来编译 LaTeX 文档，可以遵循以下方法： #### 安装必要的工具和支持包 确保已经安装了支持的 TeX 发行版，例如 MikTeX 或者 TeX Live。对于 Windows 用户来说，MikTeX 是一种常见的选择[^2]。 #### 设置 VSCode 扩展 通过安装合适的扩展来增强编辑器的功能是非常重要的。推荐使用的插件之一是 "LaTeX Workshop"，它提供了丰富的功能集用于处理 LaTeX 文件。一旦安装完成，“LaTeX Workshop” 将自动检测系统上已有的 LaTeX 工具链，并允许自定义构建命令以适应个人需求。 #### 使用 Latexmk 构建文档 Latexmk 可以简化多遍编译过程中的复杂度，尤其当涉及到交叉引用、索引等内容时更为有用。“LaTeX Workshop”的默认设置通常会调用 latexmk 命令来进行编译工作。如果需要调整具体的参数或者路径，则可以在项目的根目录下创建 `.vscode/settings.json` 文件，并加入如下配置项： ```json { "latex-workshop.latex.tools": [ { "name": "latexmk", "command": "latexmk", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "-pdf", "%DOC%" ] } ], "latex-workshop.latex.recipes": [ { "name": "latexmk", "tools": ["latexmk"] } ] } ``` 上述 JSON 片段指定了如何运行 latexmk 以及其常用选项；其中 `-pdf` 参数指示直接生成 PDF 输出而不是 DVI 格式。其他参数如 `-synctex=1`, `-interaction=nonstopmode` 和 `-file-line-error` 则有助于提高错误报告的质量和同步浏览体验。 #### 自动化预览更新 为了让每次保存文件后都能立即看到最新的渲染效果，在 settings.json 中还可以启用实时预览刷新特性： ```json "latex-workshop.view.pdf.viewer": "tab", "latex-workshop.view.pdf.internal.synctex.following.mode": "forward" ``` 这些设定使得 PDF 查看窗口会在新标签页中打开，并且能够跟随源码位置高亮显示对应的页面部分。 #### 处理依赖关系 有时项目可能依赖于额外的宏包或者其他资源文件。在这种情况下，请确认所有必需组件都已经被正确加载到本地环境中。可以通过 MiKTeX Console 或者 CTAN 下载缺失的内容。