plotly保存静态图片报错“valueerror: no renderer could be found”的根本原因是缺少官方推荐的静态渲染引擎kaleido；需卸载orca、安装kaleido（pip install kaleido），验证pio.renderers含✓标记的kaleido，再调用fig.write_image()即可正常导出png等格式。
Plotly保存静态图片报错ValueError: No renderer could be found
直接调用 fig.write_image("plot.png") 时出错，根本原因是 Plotly 默认不带静态导出能力，必须依赖外部渲染服务。Orca 曾是官方推荐方案，但已停止维护（2021 年起），现在硬装旧版 orca 或强行配置 PATH 极易失败——尤其是 macOS M1/M2、Windows WSL、conda 环境下常见 orca: command not found 或启动卡死。
改用 kaleido 替代 Orca（推荐路径）
kaleido 是 Plotly 官方当前主推的静态导出引擎，纯 Python 封装，无系统级依赖，安装快、兼容性好、支持 PDF/SVG/PNG/JPEG。
- 卸载残留 orca：
pip uninstall plotly-orca orca（避免冲突） - 安装 kaleido：
pip install kaleido - 验证是否生效：
import plotly.io as pio; print(pio.renderers)—— 输出中应含kaleido且状态为✓ - 导出代码无需修改，仍用
fig.write_image("out.png")，Plotly 会自动选kaleido后端
遇到 TimeoutError 或导出空白图怎么办
常见于图表含大量 trace、复杂 layout 或使用了未加载的字体。kaleido 默认超时 30 秒，且依赖 Chromium 渲染，但它是内置无头浏览器，不走系统 Chrome。
- 显式设置超时：
fig.write_image("out.png", engine="kaleido", timeout=60) - 简化图表再导出：临时删掉
fig.update_layout(title_font_size=...)这类非必要样式，或注释掉部分add_trace() - Windows 用户若提示
chromium download failed，手动下载缓存包：python -c "import kaleido; kaleido.scope.chromium_downloader.download_chromium()"
Linux 服务器无图形界面也能用 kaleido 吗
可以，但需确认系统具备基础字体和共享库。CentOS/RHEL 需补：yum install fontconfig freetype-devel；Ubuntu/Debian 补：apt-get install libfontconfig1 libfreetype6。Docker 用户建议基于 python:3.9-slim 而非 alpine，后者缺少 glibc 兼容层，kaleido 会静默崩溃。
真正麻烦的是某些国产信创环境（如麒麟、统信）预装的 Chromium 版本过旧，kaleido 内置版本可能不兼容——这时只能降级到 kaleido==0.2.1，并用 engine="kaleido" 显式指定。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
