VS Code中LaTeX Workshop编译.TeX文件失败，请求协助排查

从编译日志来看，核心错误是：

Latexmk: Wildcards in file names didn't match any files

这说明latexmk无法通过设置的文件名通配符找到对应的TeX文件，以下是具体解决步骤：

• 指定主文件路径：如果是多文件LaTeX项目，或当前文件不在工作区根目录，在.vscode/settings.json中明确设置主文件：

  {
    "latex-workshop.latex.rootFile": "你的主文件名.tex"
  }
  

  确保文件名和路径完全正确，不要包含空格或特殊字符。

• 检查文件名合法性：避免使用中文、空格或非ASCII字符作为TeX文件名，这类字符会干扰latexmk的通配符匹配，建议改用纯英文、下划线分隔的命名方式（比如thesis_main.tex）。

• 验证编译命令配置：打开VS Code设置，搜索latex-workshop.latex.tools，确认默认的latexmk工具配置中使用正确的变量：

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

  其中%DOC%代表当前打开的TeX文件，不要随意替换成错误的通配符（比如*.tex）。

• 重启VS Code：有时候工作区缓存或文件识别异常会导致该问题，重启后重新打开TeX文件再尝试编译。

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