macOS下VS Code编译LaTeX报spawn latexmk ENOENT错误配置求助

报错原因简单说明 #

核心问题：VS Code启动时没有加载到MacTeX的可执行文件目录，调用编译命令时找不到latexmk程序，就会抛出ENOENT（命令不存在）错误。
你需要做的PATH配置，本质就是把MacTeX存放编译程序的文件夹路径告诉LaTeX Workshop扩展，让它能搜到对应的命令。 #

分步操作 #

第一步：确认本地MacTeX的可执行文件路径 #

• 打开系统自带的「终端」App，输入命令which latexmk后按回车
• 正常会返回类似/Library/TeX/texbin/latexmk的结果，把最后一段/latexmk去掉，剩下的路径（默认安装均为/Library/TeX/texbin）复制下来备用

若执行命令后没有任何返回，说明MacTeX未安装完整，先重新运行MacTeX安装包完成全量安装后再继续后续步骤

第二步：修改VS Code配置 #

• 打开VS Code，按快捷键Cmd + Shift + P调出命令面板，输入Preferences: Open Settings (JSON)，选中对应项回车，打开用户配置JSON文件
• 在JSON文件的最外层大括号内，添加如下配置项：

"latex-workshop.latex.tools": [
    {
        "name": "latexmk",
        "command": "latexmk",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "-outdir=%OUTDIR%",
            "%DOC%"
        ],
        "env": {
            "PATH": "你第一步复制的路径:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
        }
    }
]

• 把配置里你第一步复制的路径替换成你实际查到的texbin路径，比如默认安装的话就替换成/Library/TeX/texbin。如果你的配置文件里已经有latex-workshop.latex.tools的其他配置，只需要给latexmk对应的配置块加上env字段的PATH内容即可，不用重复写整个tools数组。
• 保存修改后的settings.json文件

第三步：验证配置生效 #

• 按Cmd + Q完全退出VS Code（不要只关窗口，要彻底终止程序进程）
• 重新打开VS Code，加载需要编译的LaTeX文档，触发编译即可
• 如果仍然报错，按Cmd + Shift + P调出命令面板，输入Developer: Reload Window回车重载窗口后再尝试编译

配置原理补充 #

PATH是程序查找可执行命令的目录列表，程序调用外部命令时，会按顺序遍历PATH里列出的所有文件夹，找同名的可执行文件，找不到就会报命令不存在的错误。
上面的配置是直接给LaTeX Workshop调用latexmk的运行环境单独指定PATH，不受VS Code启动时的系统环境变量加载逻辑影响，不会出现从启动台打开VS Code读不到shell配置的问题，稳定性最高。

内容的提问来源于stack exchange，提问作者6135105654