Lightweight Charts 图表不显示的主因是容器无显式宽高或被CSS隐藏；addCandlestickSeries报错因数据结构不符：time须为统一单位的时间戳，open/high/low/close非空且升序；缩放拖拽卡顿需控制渲染节奏，如裁剪可视范围、禁用冗余图层、防抖加载。
Lightweight Charts 是目前最轻、最快、最适合金融场景的纯 Canvas 图表库，不用 SVG、不依赖 React/Vue，直接操作 DOM 容器就能渲染万级 K 线点 —— 但前提是容器尺寸、坐标系配置和数据格式必须严格对齐。
为什么 createChart 初始化后图表不显示？
最常见的原因是容器缺失显式宽高或被 CSS 隐藏。Lightweight Charts 不会自动拉伸父容器，它只读取初始化时传入的 width 和 height 值，且要求 DOM 元素已挂载并可测量。
- 确保 HTML 中的容器有明确
id，且未被display: none或visibility: hidden遮盖 - 避免在
document.body尚未 ready 时调用createChart，推荐包裹在DOMContentLoaded或document.getElementById(...)存在性校验之后 - 若用响应式布局，不要仅靠 CSS 设置
width: 100%；需在 JS 中监听resize并手动调用chart.resize(width, height)
addCandlestickSeries 报错 “Invalid data point” 怎么办？
该错误几乎全是数据结构不符合预期：K 线数据必须是数组，每个元素必须含 time、open、high、low、close 五个键，且 time 必须为 Unix 时间戳（秒级或毫秒级），不能是字符串或 Date 对象。
- 时间字段必须统一单位：服务端返回毫秒就全用毫秒，返回秒就全用秒；混用会导致坐标轴错乱甚至白屏
- 数值字段不能为
null、undefined或NaN；建议预处理时用Number()强转，并过滤掉非法项 - 数据必须按
time升序排列；逆序会触发内部断言失败，不报错但图表空白
如何让图表支持缩放与横拖，又不卡顿？
Lightweight Charts 默认启用时间轴滚动和缩放，但性能瓶颈往往出在数据量过大或频繁重绘上。关键不是关功能，而是控节奏。
立即学习“前端免费学习笔记（深入）”；
- 启用
timeScale: { fitContent: false }避免首次加载时自动缩放到全部数据，改用chart.timeScale().fitContent()按需触发 - 大数据集务必开启
visibleRange裁剪：传入{ from: startTimestamp, to: endTimestamp }，让图表只渲染可视区域数据 - 禁用不必要的图层：比如不需要网格线就设
grid: { vertLines: { visible: false }, horzLines: { visible: false } } - 避免在
onVisibleTimeRangeChanged回调里同步请求新数据；应加防抖（debounce）并配合分页加载逻辑
真正难的不是画出一根线，而是当用户拖拽到第 37 次、缩放到 0.02 倍、同时叠加 5 个指标系列时，仍能保持 60fps 渲染 —— 这取决于你对 timeScale 行为的理解深度，以及是否愿意为每组数据写一行校验逻辑。
