VSCode编译LaTeX文件报错：Recipe terminated with error

排查与修复方案 #

1. 迁移项目至本地非同步目录 #

• 将LaTeX项目从OneDrive文件夹移到本地普通目录（比如C:\Users\Pacheco\Documents\LaTeX），OneDrive的路径转义、同步锁会导致编译时文件读写失败，这是触发该错误的高频原因。

2. 补全MiKTeX组件与环境变量 #

• 打开MiKTeX Console，切换到Packages标签，搜索并安装latexmk包（默认安装可能未包含完整编译组件）。
• 调整系统PATH变量：将MiKTeX的bin目录（例：C:\Program Files\MiKTeX\miktex\bin\x64）和Perl的bin目录（例：C:\Strawberry\perl\bin）移至PATH列表顶部，避免其他软件的同名命令干扰。
• 重启VSCode和终端，使PATH变更生效。

3. 重置LaTeX Workshop配置 #

• 打开VSCode的settings.json，删除所有自定义的LaTeX Workshop配置项，恢复默认设置，排除错误编译配方的影响。
• 若需手动指定编译工具，在settings.json中添加以下配置（注意匹配你的MiKTeX安装路径）：

"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"]
    }
]

4. 验证Perl兼容性 #

• 确保安装的是Strawberry Perl，MiKTeX对该版本兼容性最优。
• 打开命令提示符，输入perl -v验证Perl是否正常运行，若报错则重新安装Perl并检查PATH配置。

5. 清理编译缓存 #

• 删除项目目录下所有临时文件（.aux、.log、.synctex.gz等），再重新编译，避免损坏的缓存文件导致错误。

内容的提问来源于stack exchange，提问作者João Vitor Pacheco