ScottPlot 安装配置指南:3 分钟跑通第一个交互式图表
【免费下载链接】ScottPlotInteractive plotting library for .NET项目地址: https://gitcode.com/gh_mirrors/sc/ScottPlot
ScottPlot 是一款免费开源的 .NET 绘图库,几行代码就能画出可交互的数据图表。本文面向刚接触 ScottPlot 的 .NET 开发者,带你完成安装、配置并跑出第一张图,全程 5 分钟。
🧭 项目定位:ScottPlot 能帮你做什么
ScottPlot是 .NET 平台的交互式绘图库:加一条折线图只要一行plt.Add.Signal,而不用自己碰画布、坐标轴和渲染细节。它支持几十万点的实时数据流,图表可缩放、可平移、可拖拽。MIT 协议,免费用于商业项目,覆盖 Windows、Linux、macOS 三大系统。
🚀 三步跑通:从 NuGet 安装到出图
第一步:通过 NuGet 安装 ScottPlot
最省事的方式是在包管理器里搜ScottPlot直接安装,依赖会一并处理好:
Install-Package ScottPlot命令执行完,包就进了你的工程。
第二步:新建控制台工程并添加引用
如果还没工程,先建一个再挂上 ScottPlot:
dotnet new console -n Quickstart dotnet add package ScottPlot两条命令分别创建工程目录和写入包引用。
第三步:运行最小示例
在Program.cs里贴入下面的代码并运行:
var plt = new ScottPlot.Plot(); double[] ys = { 1, 4, 9, 16, 25 }; plt.Add.Scatter(ys); plt.SaveFig("quickstart.png");运行后当前目录会生成quickstart.png。文件出现了,说明安装配置全部成功。
⚙️ 配置与避坑:两个最常见的安装问题
1. 现象:编译时报"程序集不兼容"或找不到目标框架。原因:当前版本 5.1.60 的目标框架为 net462、netstandard2.0、net8.0 至 net10.0,低版本 .NET 框架无法引用。处理:检查工程的TargetFramework,升级到上表任一行,或在 Package Manager 里选兼容的旧版本。
2. 现象:照老教程写plt.AddScatter()编译不过。原因:ScottPlot 4 和 5 的 API 命名不同,NuGet 默认装的是 5 系(5.1.60),5 系的写法是plt.Add.Scatter()。处理:升级前在入口处加一行版本校验,防混用:
ScottPlot.Version.ShouldBe(5);这行代码在版本不匹配时直接抛异常,比运行期报错好定位。
📊 能力速览:图表类型、数据源与平台
支持 40 余种图表:散点、折线、柱状、箱线、蜡烛、热图、饼图、雷达图等,见 食谱图库:
- 数据源:散点数组、函数曲线、OHLC 金融序列、实时 DataLogger / DataStreamer
- 控件:WinForms、WPF、Avalonia、Blazor、Eto、Maui、Notebook,核心 API 全平台一致
💡 上手建议:两条能直接落地的用法
- 数据超过一百万点时改用
Add.Signal,它按列渲染,比散点快一个数量级,适合示波器、监控类场景。 - 图表代码抽成独立方法,颜色、线型统一从一处取,多个图表风格才一致,后期换主题只改一个地方。
跑通上面的控制台示例只是起点,接下来把Quickstart换成 WinForms 或 WPF 控件,就能体验鼠标缩放和拖拽选区。
【免费下载链接】ScottPlotInteractive plotting library for .NET项目地址: https://gitcode.com/gh_mirrors/sc/ScottPlot
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考