使用bookdown构建项目遇LaTeX错误：\href命令未定义求解决

云原生阿岚

2026-8-23

解决bookdown构建PDF时的LaTeX \href未定义错误

出现! LaTeX Error: Command \href undefined.错误，核心原因是LaTeX编译时未加载hyperref宏包（\href是该包提供的命令），可通过以下方法解决：

新建或修改项目根目录下的preamble.tex文件，添加内容：
```
\usepackage{hyperref}
```
在项目的YAML配置中指定加载该宏包，两种方式任选其一：
方式1（通过自定义头文件）：
```
output:
  bookdown::pdf_book:
    includes:
      in_header: preamble.tex
```
方式2（直接指定额外依赖）：
```
output:
  bookdown::pdf_book:
    extra_dependencies:
      - hyperref
```
确认LaTeX发行版已安装hyperref包，若使用TinyTeX，可在R中运行命令安装：
```
tinytex::tlmgr_install("hyperref")
```