Dash实时图表卡住因figure不可变，须返回新对象而非原地修改；多图联动需显式启用dragmode；部署空白多因assets路径或CDN配置错误。
Plotly Dash 中实时更新图表卡住？用 dash.Dash 的 clientside_callback 或 Interval 时别直接改 figure 数据
Dash 默认不支持在回调里“就地修改” figure 字典，比如 fig['data'][0]['y'].append(new_val) —— 这会导致前端无响应或状态错乱。Dash 要求每次更新都返回一个**全新对象**。
- ✅ 正确做法：用
plotly.graph_objects.Scatter等构造新 trace，或用go.Figure.update_traces()返回新 figure - ⚠️ 常见错误：在回调中对
fig.data[0].y做.append()或.extend()，页面不动、控制台没报错但数据不刷新 - ? 场景：监控看板每 2 秒拉一次 API，需追加时间序列点；此时建议用
pd.concat()拼新 DataFrame 再重绘，比“原地 push”更稳 - ⚡ 性能提示：追加 1 个点就重绘整个 trace 没问题；但若每秒加 10+ 点，考虑用
Plotly.react()+figure.to_dict()做增量 diff（需自写 clientside callback）
用 plotly.express 快速出图后想加交互控件？别直接塞进 Dash layout，先转成 go.Figure
px.line() 返回的是 plotly.express._core.Figure，它和 Dash 回调兼容，但扩展性差——比如你想动态切换 error bar 显示、或点击高亮某条线，px 构造的 figure 缺少底层 trace 控制权。
- ✅ 推荐流程：
fig = px.line(df); fig = go.Figure(fig)，再用fig.update_traces()或fig.add_trace()补充逻辑 - ⚠️ 容易踩坑：直接对
px图调fig.data[0].hovertemplate = '...'可能失效，因为某些属性被封装了 - ? 参数差异：
px.line(x='t', y='v')自动推断列类型；转成go.Figure后必须显式传x=df['t'], y=df['v']，否则回调里 df 更新时 figure 不同步 - ? 兼容性：所有
px图都能转go.Figure，但反过来不行；生产 Dashboard 建议从go层起步，只在探索阶段用px
多图联动时点击散点图某点，其他图不更新？检查 selected_data 和 clickData 的触发条件
Dash 里图间通信靠事件属性，但 selected_data（框选/lasso）和 clickData（单击）行为差异大，且默认不开启选择功能。
- ✅ 必做设置：在
dcc.Graph(figure=fig)前，确保fig已启用选择，例如fig.update_layout(dragmode='select')或fig.update_traces(selectedpoints=[0]) - ⚠️ 错误现象：“点了没反应”，大概率是没设
dragmode，或回调函数里用了Input('graph-id', 'clickData')却实际触发了selectedData - ? 使用场景：
clickData适合单点钻取（如点员工名看详情），selectedData适合批量筛选（如框选某区域订单重算统计） - ⚡ 注意：
selectedData在缩放后可能为空，需加if selectedData and 'points' in selectedData:防崩
部署到服务器后 Dashboard 图表空白？重点查 assets/ 路径和 external_stylesheets 加载顺序
Dash 本地跑通，上线后图不显示，90% 是静态资源路径或 CSS 冲突导致 plotly.js 未正确初始化。
立即学习“Python免费学习笔记（深入）”；
- ✅ 必检项：
app = dash.Dash(__name__, assets_folder='assets')中的assets文件夹是否真在项目根目录；服务器上路径大小写敏感（Linux 下Assets≠assets） - ⚠️ 常见错误：用
external_stylesheets=['https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css']但没配external_scripts加载 Bootstrap JS，导致dbc组件错位，连带影响 graph 渲染 - ? 配置项：生产环境务必设
serve_locally=False（让 Dash 加载 CDN 版 plotly.js），否则会尝试读本地plotly.min.js并 404 - ? 兼容性：某些内网服务器屏蔽外部 CDN，此时得下载
plotly-2.24.1.min.js放进assets/，并设serve_locally=True
