Quarto渲染ggplot2代码报错：`data`不能是函数求助

问题场景 #

在Quarto中渲染包含足球场地可视化的qmd文件时触发报错，报错指向ggplot调用，但单独运行代码块正常，简单测试文件可正常渲染。

报错代码 #

ggplot(df, aes(x = X, y = Y)) +
  geom_bin2d(binwidth = c(5, 5)) +
  stat_bin2d(geom = "text", aes(label = ..count..), size = 2, binwidth = c(5, 5)) +
  scale_fill_gradient("Aantal schoten", low = "yellow", high = "red") +
  annotate_pitch(alpha = 0) +
  direction_label(x_label = 50) +
  theme_pitch() +
  theme(legend.key=element_blank()) 

错误信息 #

Error in `ggplot()`:
! `data` cannot be a function.
ℹ Have you misspelled the `data` argument in `ggplot()`
Backtrace:
 1. ggplot2::ggplot(df, aes(x = X, y = Y))
 2. ggplot2:::ggplot.function(df, aes(x = X, y = Y))

Execution halted

已排查情况 #

• 全局环境无data变量
• 单独运行代码块无问题，仅Quarto渲染时触发错误
• 显式指定data = df无法解决
• 简单ggplot测试文件可正常渲染：

---
title: "test"
---

```{r}
library(ggplot2)
library(dplyr)
iris %>%
  ggplot(aes(x = Sepal.Length, y = Sepal.Width)) +
  geom_point()

## 核心原因
报错回溯中的`ggplot2:::ggplot.function`是关键线索：**在Quarto渲染的独立环境中，`df`被识别为函数而非数据框**，导致ggplot接收了错误类型的参数。

具体可能的触发场景：
1. **命名冲突**：部分R包（如`plyr`）包含同名的`df()`函数，如果你的qmd文件中加载了这类包，且未显式定义自己的`df`数据框，就会优先调用包中的函数。
2. **数据未正确生成/加载**：渲染环境与全局环境隔离，你在全局环境中存在的`df`数据框，并未在qmd文件的代码块中正确生成或加载（比如生成`df`的代码块被设置了`eval = FALSE`，或代码执行失败但未抛出明显错误）。
3. **变量作用域问题**：如果`df`是在某个局部作用域中生成的（比如函数内部），渲染时无法在ggplot调用的作用域中访问到，导致`df`被解析为同名函数。

## 解决建议
- **检查变量类型**：在报错代码块开头添加`class(df)`或`str(df)`，渲染后查看输出，确认`df`的实际类型。
- **避免通用变量名**：将`df`改为独特的变量名（如`shot_data`），彻底规避命名冲突。
- **确保数据正确加载**：确认生成/加载`df`的代码块在报错代码块之前，且未设置`eval = FALSE`等阻止执行的参数。
- **排查包冲突**：检查加载的包列表，若存在`plyr`这类可能冲突的包，可使用`dplyr::`前缀显式调用函数，或卸载不必要的包。

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