ImPlot 初始化失败需调用 ImPlot::CreateContext() 一次且仅一次，通常在程序启动时；漏调则 ImPlot::BeginPlot 返回 false，图表空白。
ImPlot 初始化失败：ImPlot::BeginPlot 返回 false 怎么办
绝大多数图表不显示，根本原因是 ImPlot 没初始化成功。它不像 ImGui 那样在 ImGui::NewFrame() 后自动就绪，必须显式调用 ImPlot::CreateContext() —— 而且只能调一次，通常放在程序启动时（比如 main() 开头或 glfwInit() 之后）。
常见错误现象：ImPlot::BeginPlot 直接返回 false，后续所有绘图调用被跳过，控制台无报错，图表区域一片空白。
- 确认是否漏了
ImPlot::CreateContext()；如果用了多视图或多上下文（如多个ImGuiContext），每个都需要配一个ImPlotContext - 不要在每帧里重复调用
ImPlot::CreateContext()，否则会内存泄漏 + 断言失败 - 销毁前记得调
ImPlot::DestroyContext()，否则 Valgrind 或 ASan 会报泄漏 - 确保链接了
implot.lib（Windows）或-limplot（Linux/macOS），且头文件路径包含implot.h和implot_internal.h
绘制折线图：ImPlot::PlotLine 的数据传参陷阱
ImPlot::PlotLine 看似简单，但数据指针和长度不匹配是高频崩溃点。它不拷贝数据，只存裸指针 + 计数，一旦原始数组生命周期结束（比如局部 std::vector 在函数返回后析构），下帧绘图就会访问野指针。
使用场景：实时传感器数据、仿真时间序列、调试变量跟踪。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 别传栈上数组地址（如
float xs[100]）给跨帧使用的 plot - 推荐用
std::vector并保持其存活，传&data[0]和data.size()；C++20 可用data.data() - 注意 X/Y 数据长度必须一致，
ImPlot::PlotLine("label", xs, ys, count)中count是元素个数，不是字节数 - 若 X 轴想用索引（0,1,2…），可省略
xs参数，直接写ImPlot::PlotLine("y", ys, count)
static std::vector<float> history;
history.push_back(new_value);
if (history.size() > 1000) history.erase(history.begin());
ImPlot::PlotLine("Signal", history.data(), history.size());多图层与坐标轴：为什么 ImPlot::PushStyleVar 不生效
想改某条线颜色或粗细，直接对全局 style 调用 ImPlot::PushStyleVar 没用——它只影响 *当前 plot 内* 后续的绘图项，而且必须在 ImPlot::BeginPlot 之后、ImPlot::EndPlot 之前调用。
性能影响：style 变量压栈/出栈开销极小，但滥用（比如每帧 push/pop 十几次）会轻微拖慢 UI 线程。
- 设置单条线样式：在
ImPlot::PlotLine前加ImPlot::PushStyleVar(ImPlotStyleVar_LineWeight, 2.5f)，再紧跟ImPlot::PopStyleVar() - Y 轴双刻度（如左电压、右电流）需用
ImPlot::SetupAxis配置ImPlotYAxis_1和ImPlotYAxis_2，并为对应曲线指定ImPlotYAxis_2作为 target - 时间轴（
ImPlotTime）需用ImPlot::SetupAxisFormat配合ImPlotFormatterDateTime，不能直接传time_t
交互卡顿或掉帧：ImPlot::EndPlot 后没清理临时缓存
ImPlot 内部会为每个 plot 缓存渲染用的顶点缓冲（尤其带大量点或启用抗锯齿时）。如果你每帧动态创建几十个 plot（比如按配置生成 N 个子窗口图表），又不手动管理，GPU 内存会缓慢上涨，几小时后明显卡顿。
容易被忽略的地方：ImPlot 没提供“清空所有 plot 缓存”的 API，它的资源释放完全依赖 ImPlotContext 生命周期。
- 避免每帧 new 一堆
ImPlot::BeginPlot(...)—— 改用固定数量 plot + 条件显示（if (show_plot) { ... }） - 若必须动态增删，每次删 plot 前确保其已退出（即
ImPlot::EndPlot()已调用），然后靠ImPlot::DestroyContext()+ImPlot::CreateContext()重置（慎用，有闪屏） - 调试时打开
IMGUI_DEBUG_LOG宏，看 ImPlot 是否频繁报告"Vertex buffer overflow"
真正麻烦的是混合使用 ImGui 和 ImPlot 的缩放/拖拽逻辑——比如你监听了 ImGui::IsWindowHovered()，但忘了 ImPlot::GetPlotDrawList() 的坐标系是 plot 本地空间，直接套用窗口坐标会偏移。这点没人提，但查 bug 要半天。
