直接用plotly.graph_objects.candlestick会丢数据，因其要求输入为等长、无nan的python list或numpy array，不接受带索引的dataframe列；需用.tolist()或.values转换并清洗nan。
为什么直接用 plotly.graph_objects.Candlestick 会丢数据？
常见错误是把原始 OHLC 数据（比如 pandas DataFrame）直接塞进 Candlestick，结果图上只显示一根蜡烛或完全空白。根本原因是 Candlestick 要求输入必须是 Python 原生 list 或 numpy array，且长度一致、无 NaN —— 它不接受带索引的 DataFrame 列直接传入。
实操建议：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
- 用
df['open'].tolist()或df['open'].values显式转为序列，别传df['open'] - 检查四列是否等长：
len(open) == len(high) == len(low) == len(close)，否则报ValueError: All arguments must be the same length - 用
df.dropna(subset=['open','high','low','close'])清洗，别依赖plotly自动跳过
怎么让 K 线图支持缩放 + 时间范围选择？
默认 go.Figure() 没有内置时间轴交互逻辑，得手动配 xaxis 类型和工具栏。关键不是加按钮，而是告诉 Plotly 这列是时间类型。
实操建议：
- 确保时间列是
datetime64[ns]类型，用df['date'] = pd.to_datetime(df['date']) - 在
go.Candlestick(x=df['date'])中传入该列，Plotly 才能识别为时间轴 - 启用缩放：设置
fig.update_xaxes(type='date', rangeslider_visible=True)，rangeslider是开关，不是可选组件 - 若想限制初始视图，加
range=[start_date, end_date]，格式必须是字符串如'2023-01-01'
如何叠加成交量柱状图且保持时间轴对齐？
单独画 K 线和成交量容易错位，因为两组数据时间点不完全重合（比如成交量含午休空档，K 线不含），Plotly 不会自动对齐 x 轴坐标。
实操建议：
- 用同一份
df的'date'列作为两个 trace 的x参数，别用不同数据源的时间列 - 成交量用
go.Bar(x=df['date'], y=df['volume'], name='Volume')，注意y是数值，不是字符串 - 共享 x 轴：调用
fig.update_layout(xaxis=dict(rangeslider=dict(visible=False)))关掉成交量下方的冗余滑块，只留 K 线下的那个 - 设高度比例：
fig.update_layout(height=600)，否则小图里成交量柱子挤成一条线
导出 HTML 后交互失效？检查这三个地方
本地双击打开 .html 文件时，缩放、悬停提示、时间滑块全失效，大概率是资源加载问题，不是代码写错。
实操建议：
- 别用
fig.write_html('kline.html')默认方式，改用fig.write_html('kline.html', include_plotlyjs='cdn')，强制走 CDN 加载 JS - 如果必须离线使用，改用
include_plotlyjs='directory'，它会生成_plotlyjs/文件夹，整个目录要一起分发 - 浏览器地址栏看到
file:///开头就危险——Chrome 默认禁用本地 file 协议的 JS 执行，换用python -m http.server启个临时服务再访问
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
