使用tar_quarto()时Quarto误报代码块标签重复的解决咨询

问题背景 #

在targets工作流中使用tar_quarto()生成Quarto报告时，knitr提示存在重复的代码块标签tbl-modelsummary，但实际.qmd文件里只定义了一次该标签。涉及环境：

• R 4.6.0
• targets 1.12.0
• modelsummary 2.6.0
• tarchetypes 0.14.1
• quarto 1.5.1
• 运行系统：macOS Tahoe 26.5.1（ARM芯片）、Windows远程桌面服务器（版本一致）

原因分析 #

核心问题是modelsummary的自动标签生成和用户手动定义的标签冲突：

• modelsummary输出表格时，默认会自动给生成的Quarto表格添加标签，默认格式就是tbl-modelsummary，如果用户没手动指定label参数，这个自动标签就会被插入到输出内容里。
• 当你在.qmd的代码块里手动设置了#| label: tbl-modelsummary，就会和modelsummary自动生成的标签重复，触发knitr的重复标签检测错误。
• tar_quarto()的运行机制可能会让这个冲突更明显，但本质是两个组件的标签逻辑撞车了。

修复方案 #

1. 给modelsummary指定自定义标签 #

调用modelsummary()时，用label参数显式设置一个唯一标签，覆盖默认的自动生成值：

modelsummary(your_model, label = "tbl-custom-model-1")

同时把.qmd代码块里的#| label改成对应的名称，或者直接删掉代码块的手动标签，让modelsummary的自动标签唯一。

2. 禁用modelsummary的自动标签生成 #

如果不需要自动生成标签，调用时设置label = NULL：

modelsummary(your_model, label = NULL)

这样就不会自动添加标签，只会用你手动在代码块里定义的标签（如果有的话）。

3. 排查targets工作流的重复渲染 #

检查_targets.R里有没有重复调用tar_quarto()，或者其他target是否触发了报告的多次渲染，导致标签被重复注册。可以用tar_visnetwork()可视化工作流，排查冗余步骤。

是否属于Bug？ #

不算严格意义上的bug，是默认行为的冲突：modelsummary的自动标签逻辑没考虑到用户可能手动设置相同标签的场景，而knitr的重复标签检测是严格的防护机制。你可以考虑给modelsummary提交功能请求，建议添加全局配置默认标签前缀的选项，避免这类冲突。

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