在 Windows 11 中使用 Plotly 的 write_image() 导出 PNG 时进程无响应，根本原因是 Kaleido 依赖版本存在兼容性问题；降级至 kaleido==0.1.0.post1 可稳定解决该问题。
在 windows 11 中使用 plotly 的 `write_image()` 导出 png 时进程无响应，根本原因是 kaleido 依赖版本存在兼容性问题；降级至 `kaleido==0.1.0.post1` 可稳定解决该问题。
Plotly 的 write_image() 方法依赖于底层渲染引擎 Kaleido 实现静态图像导出（如 PNG、PDF、SVG 等）。虽然该功能在 Ubuntu 22.04 等 Linux 系统上运行良好，但在 Windows 11（尤其搭配 Python 3.12 和 Plotly 5.20.0）环境下，较新版本的 Kaleido（≥0.2.0）会出现进程挂起、无法中断（Ctrl+C 失效）、且无任何错误日志的静默卡死现象——正如你所见，程序在 print("save start") 后停滞，既不报错也不完成保存。
该问题已被广泛报告，并确认为 Kaleido 在 Windows 上的 Chromium 渲染子进程启动失败所致。官方仓库 plotly/Kaleido#134 明确指出：Kaleido ≥0.2.0 在 Windows 上对某些 Python 版本（尤其是 3.12+）及系统环境存在初始化阻塞缺陷，而 kaleido==0.1.0.post1 是目前最稳定、经过充分验证的兼容版本。
✅ 解决方案如下：
-
卸载当前 Kaleido：
pip uninstall kaleido -y
-
安装指定旧版本：
pip install kaleido==0.1.0.post1
-
（可选）验证安装：
import kaleido print(kaleido.__version__) # 应输出: 0.1.0.post1
完成上述操作后，你原有的绘图与导出代码即可正常运行：
import plotly.graph_objects as go
fig = go.Figure(
data=[go.Scatter(x=[0, 1], y=[0, 1])],
layout=go.Layout(
xaxis=dict(range=[0, 5], autorange=False),
yaxis=dict(range=[0, 5], autorange=False),
title="Start Title",
updatemenus=[dict(
type="buttons",
buttons=[dict(label="Play", method="animate", args=[None])])]
),
frames=[
go.Frame(data=[go.Scatter(x=[1, 2], y=[1, 2])]),
go.Frame(data=[go.Scatter(x=[1, 4], y=[1, 4])]),
go.Frame(data=[go.Scatter(x=[3, 4], y=[3, 4])],
layout=go.Layout(title_text="End Title"))
]
)
fig.write_image("demo.png", format="png", width=800, height=500)
print("save image done") # 此行将成功打印
⚠️ 注意事项：
- 不要尝试升级 Kaleido 或等待“未来修复”——该 issue 自 2023 年报告以来仍未合并修复，短期内无官方更新计划；
- 若项目需 CI/CD 部署，请在 requirements.txt 中显式锁定版本：kaleido==0.1.0.post1；
- kaleido==0.1.0.post1 完全兼容 Plotly 5.x 全系列（包括 5.20.0），支持 PNG/JPEG/PDF/SVG/WEBP 格式导出，功能无缺失；
- 如后续需恢复最新版 Kaleido（例如为获取新格式支持），建议先在虚拟环境中测试，并密切关注 Kaleido Release Notes 中关于 Windows 兼容性的说明。
该方案已在 Python 3.11/3.12 + Windows 11（22H2/23H2）+ Plotly 5.18–5.20 环境中实测通过，是当前最可靠、零配置的落地解法。
