VS Code LaTeX Workshop扩展报错：Biber无法找到Thesis.bcf

问题描述 #

使用VS Code的LaTeX Workshop扩展编译LaTeX文档时，Biber持续报错：

INFO - This is Biber 2.20
INFO - Logfile is 'Thesis.blg'
ERROR - Cannot find 'Thesis.bcf'!
INFO - ERRORS: 1

但在终端手动执行以下编译命令时完全正常：

pdflatex Thesis
biber Thesis
pdflatex Thesis
pdflatex Thesis

相关配置与文件结构：

• config/Config.tex中的biblatex配置：

\usepackage[
    bibstyle=authoryear,
    citestyle=ieee,
    giveninits=false,
    natbib=true,
    urldate=long,
    %url=false,
    date=long,                
    dashed=false, 
    maxcitenames=3,
    maxbibnames=99,   
    backend=biber
]{biblatex}

\bibliography{library/BachelorThesis}

• 项目文件夹结构：

config
 ┣ Config.acn
 ┣ Config.glo
 ┣ Config.log
 ┣ Config.mtc
 ┣ Config.mtc0
 ┣ Config.tex
 ┗ List_of_abbreviations.tex

library
 ┗ BachelorThesis.bib

Thesis.tex

已尝试重装LaTeX Workshop扩展，且确认Biber路径设置为/Library/TeX/texbin/biber，问题仍未解决。

解决方法 #

1. 核对LaTeX Workshop编译命令配置 #

检查扩展的编译序列与工具参数，确保Biber指向正确的主文件：

• 打开VS Code设置，搜索latex-workshop.latex.recipes，确认编译序列包含pdflatex -> biber -> pdflatex*2的正确流程；
• 搜索latex-workshop.latex.tools，查看biber工具的配置，确保参数为%DOCFILE%，示例：

  {
      "name": "biber",
      "command": "biber",
      "args": ["%DOCFILE%"],
      "env": {}
  }
  

  %DOCFILE%会自动替换为当前编译的主文件名（即Thesis），避免手动指定错误路径。

2. 确保编译主文件而非子文件 #

检查Thesis.tex是否正确通过\input{config/Config}引入配置文件，且在VS Code中编译时，需确保当前激活的是Thesis.tex文件，再点击右上角的编译按钮。若误将Config.tex作为主文件编译，不会生成Thesis.bcf，导致Biber报错。

3. 清理编译缓存后重试 #

手动删除以下临时文件，再重新用扩展编译：

• 根目录下的Thesis.bcf、Thesis.blg、Thesis.aux、Thesis.bbl文件；
• config/目录下的Config.acn、Config.glo等临时编译产物。

4. 检查输出目录设置 #

若设置了自定义输出目录，可能导致Biber无法找到.bcf文件：

• 搜索VS Code设置latex-workshop.latex.outDir，暂时将其设为空（使用默认输出目录），测试编译是否正常。

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