Quarto-Shiny文档中renderEcharts4r函数找不到问题求助

核心排查步骤 #

• 强制加载目标包：必须在代码开头明确执行 library(echarts4r)，不要依赖R的自动加载机制。哪怕包已安装且函数面板可见，当前会话未加载时就会触发找不到函数的错误。
• 用命名空间指定调用：如果存在潜在的函数名冲突（概率较低），直接用命名空间前缀调用：echarts4r::renderEcharts4r()，确保调用的是echarts4r包中的目标函数。
• 验证包安装环境：
  • 运行 .libPaths() 查看R的包安装路径，确认echarts4r安装在当前R 4.3.2的默认路径下，而非旧版本R的路径。
  • 执行 packageVersion("echarts4r") 确认版本确实为0.4.5，避免安装失败但无提示的情况。
• 检查文档/应用结构：
  • 若是Quarto文档，确保代码块开头有 {r} 标签，且未设置限制包加载的参数。
  • 若是Shiny应用，确认 renderEcharts4r 放在 server 函数内部，且UI部分配对使用了 echarts4rOutput()，两者必须一一对应。

可复现代码调整示例 #

如果你的代码结构类似下方，按上述要点调整：

# 明确加载依赖包
library(shiny)
library(echarts4r)

ui <- fluidPage(
  radioButtons("chart_type", "选择图表类型", choices = c("折线图", "柱状图")),
  echarts4rOutput("demo_chart")
)

server <- function(input, output) {
  output$demo_chart <- echarts4r::renderEcharts4r({
    mtcars |> 
      e_charts(x = mpg) |> 
      (function(data) {
        if(input$chart_type == "折线图") {
          data |> e_line(disp)
        } else {
          data |> e_bar(disp)
        }
      })()
  })
}

shinyApp(ui, server)

极端情况处理 #

若以上步骤无效，尝试彻底卸载重装：

# 卸载包
remove.packages("echarts4r")
# 清理残留缓存
unlink(file.path(Sys.getenv("R_LIBS_USER"), "echarts4r"), recursive = TRUE)
# 重新从CRAN安装
install.packages("echarts4r")

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