Quarto博客文章缩略图无法显示问题求助

检查路径与文件名一致性 #

• 确保文章头部image字段的路径和文章内图片引用路径完全匹配。比如文章内用![](images/An intro to chi-squared test.png)，头部就要写成image: "images/An intro to chi-squared test.png"，不要省略images/目录，主页渲染缩略图时不会自动补全目录层级。
• 避免使用URL编码的空格（%20），直接用空格或换成下划线（比如An_intro_to_chi-squared_test.png），部分主题对带空格的文件名兼容性较差。
• 严格匹配文件名大小写，Quarto对文件名大小写敏感（比如PNG和png会被识别为不同文件）。

验证文件实际位置 #

确认图片文件确实存放在博客项目的images目录下（或你指定的对应目录），没有出现文件误放、删除或重命名的情况。

检查主题缩略图规则 #

• 部分Quarto主题要求缩略图为特定尺寸（比如1200×630像素的社交媒体标准尺寸），尺寸不符可能导致加载异常，可调整图片尺寸后重试。
• 查看所用主题的文档，确认是否需要配置thumbnail字段而非image字段，部分主题会区分这两个参数的用途。

清理缓存后重新构建 #

执行命令quarto clean清理旧渲染缓存，再用quarto render重新构建整个博客，避免缓存文件导致的路径冲突。

内容的提问来源于stack exchange，提问作者Vinícius Félix