tufte-book类LaTeX跨子文件\label/\ref引用失效问题咨询

• 先确认编译流程正确
  LaTeX交叉引用本身就需要至少两轮编译才能生效：第一次编译主文件main.tex时，所有\label定义才会写入.aux辅助文件，第二次编译时编译器才会读取这些标签信息填充\ref内容。连续编译主文件至少2次，直到编译日志里没有LaTeX Warning: Reference(s) may have changed. Rerun to get cross-references right.的提示为止。如果文档同时有目录、参考文献、索引，需要再多编译1-2轮。
  注意绝对不要单独编译子文件a.tex或b.tex，所有编译操作必须针对主文件main.tex执行，否则标签会写入子文件独立的.aux，主文件编译时读不到。
• 排查tufte-book类的特有兼容性问题
  tufte-book重写了边注、浮动体的排版逻辑，会干扰默认的标签写入机制，这是tufte类最常见的交叉引用bug来源。先做最小测试：在a.tex的普通正文段落里（不要放在sidenote/marginnote边注、浮动体、自定义特殊环境内）写入普通文本加\label{stuff}，在b.tex普通正文里写\ref{stuff}测试。如果这样能正常引用，说明是特殊环境导致标签写入失败。
  如果标签必须放在边注、浮动体里，在导言区最后加载refcount包，或者在hyperref之后加载cleveref包即可修复tufte类的引用重写bug，导言区添加代码：

  \usepackage{refcount}
  % 用cleveref的话必须放在所有宏包的最后，hyperref之后
  % \usepackage{cleveref}
  

• 排查标签本身的错误
  首先检查标签拼写：LaTeX标签大小写敏感，\label{stuff}和\ref{Stuff}会被识别为不同标签，确认两边拼写完全一致，没有多余空格、特殊字符。
  然后检查重复标签：如果其他位置（包括intro.tex、模板自定义命令里）也定义了同名的\label{stuff}，会出现标签覆盖，编译日志会提示LaTeX Warning: Label 'stuff' multiply defined.，把标签名改成唯一值比如\label{chap:a:stuff}即可。
  最后确认标签位置正确：\label必须放在有自动编号计数器的结构之后，比如带编号的章节、图、表、定理环境紧邻的位置，不要放在无编号的章节、无标题的浮动体附近，否则拿不到正确的编号值。
• 排查辅助文件损坏问题
  如果之前编译过程出错中断，很容易导致.aux等辅助文件写入损坏，标签信息无法正常读取。直接删除工作目录下所有.aux、.out、.toc、.lof、.lot后缀的辅助文件，从头连续编译2-3次主文件即可。
  用\include导入子文件时，编译一次后工作目录会生成a.aux和b.aux，打开a.aux查找是否有\newlabel{stuff}{{...}{...}}的条目，如果没有，说明标签根本没被成功写入，回到上一步检查标签所在环境的问题。
• 排查文件导入路径错误
  确认a.tex、b.tex和main.tex放在同一目录下，文件名完全匹配——Windows默认隐藏已知文件后缀，很容易出现a.tex.tex这类命名错误，导致文件实际没有被导入，标签自然不存在。编译日志如果出现LaTeX Error: File 'a.tex' not found.的提示，就是路径问题。

快速定位问题方案：把a.tex简化为\chapter{测试章节A}\label{stuff}，b.tex简化为\chapter{测试章节B} 引用A章节编号：\ref{stuff}，删掉所有辅助文件后连续编译两次主文件，如果还是无法正常显示，直接按第二点加refcount包即可解决tufte类的兼容性问题。

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