如何配置LaTeX让nameref无效引用触发构建失败而非警告

你可以通过两种常用方案实现将未定义引用从警告升级为错误，终止构建：

方案1：修改原生引用逻辑（无额外依赖，适配nameref） #

直接在导言区加入以下代码，重写LaTeX原生的引用解析逻辑，将未定义引用的警告替换为错误：

\makeatletter
% 重写引用处理逻辑，未定义引用直接抛错误
\def\@setref#1#2#3{%
  \ifx#1\relax
    \@latex@error{Reference `#3' on page \thepage \space undefined}\@ehc
  \else
    \expandafter#2#1\relax
  \fi
}
\makeatother

该方案对所有基于标准LaTeX引用机制的命令都生效，包括\ref、\pageref、\nameref、\autoref等。

注意：首次编译时还未生成.aux引用缓存文件，所有引用都会被判定为未定义，会直接触发报错。你可以首次编译时先不加这段配置，生成.aux文件后再加，或者配合编译脚本判断编译轮次使用。

方案2：使用strictref包 #

如果你不介意引入额外包，可以直接加载strictref包，它默认会将所有未定义引用转为错误，自动适配nameref：

\usepackage{strictref}

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