如何在Rmarkdown（bookdown PDF输出）中用gt包生成带编号标题的表格

gt包默认的标题机制并不直接兼容bookdown的表格编号与交叉引用逻辑，下面提供两种可行的解决方法：

方法一：利用gt的tab_caption()嵌入bookdown标签 #

在tab_caption()的标题文本中添加(#tab:你的标签名)格式的标签，bookdown就能识别并自动为表格编号。示例代码如下：

---
title: "gt表格编号测试"
output: bookdown::pdf_document2
---

## 测试章节

下面是一个带自动编号标题的gt表格：

```{r tab:mtcars-summary}
library(gt)

# 生成gt表格并设置带bookdown标签的标题
mtcars[1:5, c("mpg", "cyl", "disp")] |>
  gt() |>
  tab_caption(caption = "前5行mtcars数据集的基本信息 (#tab:mtcars-summary)")

可以通过标签引用表格：@ref(tab:mtcars-summary)

如果此方法无效，优先检查`gt`包版本，需更新至0.8.0及以上版本（旧版本不支持解析bookdown标签）。

## 方法二：手动用LaTeX表格环境包裹gt输出

将gt表格转换为LaTeX代码后，手动嵌入bookdown支持的`table`环境，确保标签被正确识别。示例代码：

```rmarkdown
---
title: "gt表格编号测试"
output: bookdown::pdf_document2
---

## 测试章节

下面是手动配置LaTeX环境的gt表格：

```{r tab:mtcars-latex, results='asis'}
library(gt)

# 生成gt表格并转为LaTeX代码
gt_table <- mtcars[1:5, c("mpg", "cyl", "disp")] |>
  gt() |>
  as_latex()

# 用LaTeX table环境包裹，添加带bookdown标签的标题
cat("\\begin{table}[ht]
  \\centering
  \\caption{前5行mtcars数据集的基本信息 (#tab:mtcars-latex)}
  ", as.character(gt_table), "
\\end{table}")

引用表格：@ref(tab:mtcars-latex)

## 关键注意事项
- 包版本要求：`gt` >= 0.8.0，`bookdown` >= 0.29，版本过低会导致标签识别失败
- 渲染方式：必须使用`bookdown::render_book()`函数或RStudio的「Build Book」功能，普通Knit按钮无法触发bookdown的交叉引用逻辑

内容的提问来源于stack exchange，提问作者A. Bohyn