Spectre.Console图表绘制教程BarChart与BreakdownChart在终端画出漂亮统计图【免费下载链接】spectre.consoleA .NET library that makes it easier to create beautiful console applications.项目地址: https://gitcode.com/gh_mirrors/sp/spectre.consoleSpectre.Console是一款流行的 .NET 终端 UI 库只需几行代码就能在命令行里画出漂亮的统计图。本文是一份完整的终端图表绘制教程带你快速上手两大图表组件BarChart条形图与BreakdownChart占比图——从安装步骤、3 行代码出图到属性调优与本地化让终端数据汇报瞬间变专业。 为什么用 Spectre.Console 画终端图表大多数 CLI 工具还在输出纯文本数字而 Spectre.Console 让你用字符画出真正的图表纯文本渲染用█、■等字符绘制任何终端都能显示跨 Windows / macOS / Linux链式 API.Width(60).Label(标题).AddItem(...)一路串下去代码极短零依赖、开箱即用无需图形库直接AnsiConsole.Write即可。上图为 Spectre.Console 终端图表绘制效果演示下方 Charts 区域展示了 BarChart 条形图与 BreakdownChart 占比图的真实渲染效果。核心实现都在 src/Spectre.Console/Widgets/Charts/ 目录下条形图BarChart.cs占比图BreakdownChart.cs 快速上手安装 Spectre.Console在 .NET 项目中用 NuGet 一条命令安装dotnet add package Spectre.Console想阅读源码的话也可以克隆仓库git clone https://gitcode.com/gh_mirrors/sp/spectre.console BarChart 教程3 行代码画出条形图BarChart 是最常用的终端条形图适合对比各项数值大小。官方测试用例BarChartTests.cs就是标准写法using Spectre.Console; AnsiConsole.Write(new BarChart() .Width(60) .Label(Number of fruits) .AddItem(Apple, 12, Color.Green) .AddItem(Orange, 54, Color.Orange) .AddItem(Banana, 33, Color.Yellow));终端中渲染出的效果真实输出节选自 Render.Output.verified.txtNumber of fruits Apple ████████ 12 Orange █████████████████████████████████████████████████ 54 Banana ████████████████████████████ 33每根条的长短自动按最大值归一化颜色通过 BarChartItem 的Color参数指定可省略省略时用默认色。BarChart 常用属性速查方法作用示例.Label(...)图表标题支持 Markup 语法上色.Label([red]销售统计[/]).Width(60)固定图表宽度.Width(60).WithMaxValue(100)固定最大值锁定比例尺.WithMaxValue(100).HideValues()隐藏条末的数字.HideValues().LeftAlignLabel()标题对齐方式默认居中.RightAlignLabel().Culture(zh-CN)数字本地化格式.Culture(sv-SE)进阶技巧用 WithMaxValue 固定比例尺多张图并排时条长才能直接横向对比例如满分 100 分的成绩统计用.WithMaxValue(100)更直观见 Fixed_Max_Value 输出。 BreakdownChart 教程一条彩色长条展示占比想表达整体由哪些部分构成如项目语言分布、磁盘占用就用 BreakdownChart——它把数据合并成一条堆叠彩色长条 图例标签视觉冲击比条形图更强。AnsiConsole.Write(new BreakdownChart() .Width(60) .AddItem(SCSS, 37, Color.Red) .AddItem(HTML, 28.3, Color.Blue) .AddItem(C#, 22.6, Color.Green) .AddItem(JavaScript, 6, Color.Yellow) .ShowPercentage());渲染效果节选自 Default.Output.verified.txt████████████████████████████████████████████████████████████████████████████████ ■ SCSS 37 ■ HTML 28.3 ■ C# 22.6 ■ JavaScript 6⚠️ 注意一个小坑BreakdownChart 的AddItem颜色参数必填无默认值定义见 BreakdownChart.cs。让 BreakdownChart 更精致的 4 个开关方法效果.ShowPercentage()标签显示百分比见 ShowPercentage 实现.HideTags()/.HideTagValues()只显示彩条或隐藏图例中的数值.FullSize()图例展开为每行一项的完整模式.WithValueColor(Color.Red)自定义图例数值的颜色默认灰色 BarChart vs BreakdownChart怎么选对比项BarChart条形图BreakdownChart占比图图形形态多条横向条各自独立单条堆叠彩条 图例适合场景数值大小对比销量、成绩整体构成比例语言分布、存储占用颜色可省略默认色必须指定数值标签默认显示可HideValues()默认显示可ShowPercentage()数据来源IBarChartItemIBreakdownChartItem经验法则要比谁大用 BarChart要看构成用 BreakdownChart两者混排就是一张漂亮的终端统计图。 本地化与数字格式定制两个图表都实现了IHasCulture接口支持地区格式.Culture(sv-SE)后数字自动按瑞典语风格显示小数点测试参考 Culture.Output.verified.txt自定义格式.UseValueFormatter((v, c) string.Format(c, {0} MB, v))可把单位、货币符号等直接画进图里。BarChart 的条形本身由 ProgressBar 组件驱动Unicode 下使用█字符填充因此它也天然继承了对宽终端的自适应能力。✅ 常见问题速答Q1图表没有占满终端宽度BreakdownChart 默认Expand true会撑满可用宽度想要定宽就显式.Width(60)。BarChart 未设宽度时同样取终端最大宽度。Q2颜色只有那么几种Spectre.Console 支持 2-bit 到 24-bit1670 万色自动转换Color.Red、Color.Orange等内置色板见 Color.cs终端不支持时会优雅降级。Q3数据是集合怎么办两个图表都提供.AddItems(items)批量添加方法也支持传入自定义转换函数见 BarChart.cs。 相关模块速查内容路径条形图实现src/Spectre.Console/Widgets/Charts/BarChart.cs占比图实现src/Spectre.Console/Widgets/Charts/BreakdownChart.cs条形图测试用例src/Spectre.Console.Tests/Unit/Widgets/BarChartTests.cs渲染效果基线src/Spectre.Console.Tests/Expectations/Widgets/至此你已经掌握 Spectre.Console 图表绘制的核心用法安装只需 1 条命令出图只需 3 行代码。把 BarChart 与 BreakdownChart 加进你的 CLI 工具数据统计再也不会只是冷冰冰的数字了 【免费下载链接】spectre.consoleA .NET library that makes it easier to create beautiful console applications.项目地址: https://gitcode.com/gh_mirrors/sp/spectre.console创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考