在Rpubs发布含外部CSV的Quarto Observable文档遇加载问题

安全阿岳

2026-7-13

解决Quarto Observable文档发布到Rpubs的加载失败问题

核心问题排查方向

发布到Rpubs后加载失败，结合本地正常运行、警告信息及代码片段，问题主要集中在资源路径/嵌入配置、变量引用一致性和Quarto版本兼容性三个方面。

1. 修复废弃的`--self-contained`配置

你收到的警告提示--self-contained已被弃用，需在文档YAML头部替换为新的配置项，确保资源正确嵌入：

---
title: 你的文档标题
format:
  html:
    embed-resources: true
    standalone: true
---

该配置会将所有依赖（包括CSV、脚本、样式）打包成单个HTML文件，避免Rpubs上的路径解析问题。

2. 确保CSV文件被正确包含

发布时需确认附属资源被Quarto打包：

在R Studio发布对话框中，勾选Include document dependencies选项；
或者在文档YAML中显式声明资源：

resources:
  - LongTableBar.csv

这能保证CSV文件随文档一起上传到Rpubs，避免FileAttachment找不到文件的情况。

3. 检查Observable变量引用一致性

你的代码中，处理CSV的变量是LT，但生成图表时用的是further_test——如果further_test未正确关联到LT的处理结果，会导致数据加载失败。修正图表代码中的数据源：

Plot.plot({
  color: {legend: true},
  y: {grid: true},
  x: {axis: null},
  marks: [
    Plot.ruleY([0]),
    // 将further_test替换为LT
    Plot.barY(LT, {x: "ID", y: "Percentage", sort: {x: "y", reverse: true}, fill: (d) => colorScale(d.intersections)})
  ]
})

如果further_test是LT的后续处理变量，需确保该变量的定义在Observable代码中正确执行，无异步加载遗漏。