开发工具【免费下载链接】pterm✨ PTerm is a modern Go module to easily beautify console output. Featuring charts, progressbars, tables, trees, text input, select menus and much more Its completely configurable and 100% cross-platform compatible.项目地址https://gitcode.com/gh_mirrors/pt/pterm点击查看免费下载本文以 PTerm 官方示例_examples/heatmap/demo为核心系统讲解HeatmapPrinter热力图打印器的完整用法如何组织float32数据矩阵、如何用HeatmapAxis配置 X/Y 轴标签、如何使用WithEnableRGB()开启平滑的 TrueColor 渐变着色以及图例Legend、边框Boxed与网格Grid等布局细节的底层实现。读完本文你可以在自己的 Go 命令行工具中直接复现示例效果并依据需求定制配色、图例与网格。热力图能做什么热力图Heatmap以颜色深浅直观表达二维矩阵中数值的大小分布数值越大颜色越暖或越偏向范围高端数值越小颜色越冷或越偏向范围低端。PTerm 的HeatmapPrinter在终端里用背景色 数值 边框/网格的方式渲染这种矩阵非常适合展示时间段内的数据波动、二维采样结果、相关矩阵等场景。与柱状图BarChartPrinter、表格TablePrinter不同热力图的价值在于整面看趋势密集的彩色单元格构成连续的视觉场异常值如示例矩阵中的-1.0与1会在色带上形成明显的凸起。最小可运行示例_examples/heatmap/demo/main.go是一个自包含的完整程序直接go run即可看到效果cd _examples/heatmap/demo go run main.go示例源码如下与文档一致可直接复制package main import ( github.com/pterm/pterm ) func main() { // Each inner slice is one row; cell colors are scaled between the // smallest and largest value in the whole matrix. data : [][]float32{ {0.9, 0.2, -0.7, 0.4, -0.5, 0.6, -0.3, 0.8, -0.1, -1.0, 0.1, -0.8, 0.3}, {0.2, -0.7, -0.5, -0.3, -0.1, 0.1, 0.3, 0.5, 0.9, -0.9, -0.7, -0.5, -0.3}, {0.4, 0.4, -0.3, -1.0, 0.3, -0.2, -0.9, 0.5, -0.3, -1.0, 0.6, -0.2, -0.9}, {0.9, -0.5, -0.1, 0.3, 1, -0.7, -0.3, 0.1, 0.7, -0.9, -0.5, 0.2, 0.6}, {0.5, 0.6, 0.1, -0.2, -0.7, 0.8, 0.6, 0.1, -0.5, -0.7, 0.7, 0.3, 0.0}, } // Axis labels must match the data: one X label per column, one Y label per row. headerData : pterm.HeatmapAxis{ XAxis: []string{a, b, c, d, e, f, g, h, i, j, k, l, m}, YAxis: []string{1, 2, 3, 4, 5}, } // WithEnableRGB uses smooth TrueColor gradients instead of the ANSI palette. pterm.DefaultHeatmap.WithAxisData(headerData).WithData(data).WithEnableRGB().Render() }这段代码展示了一条典型的 PTerm 链式调用pterm.DefaultHeatmap是包级默认实例定义于 heatmap_printer.go通过.WithAxisData(...)、.WithData(...)、.WithEnableRGB()返回配置好的副本最后.Render()输出到终端。若想在变量中拿到渲染后的字符串而不是直接打印可改用Srender()——它返回(string, error)适合把热力图嵌套进其他打印器。数据模型HeatmapData 矩阵热力图的数据类型是HeatmapData本质就是[][]float32见 heatmap_printer.gotype HeatmapData [][]float32三条必须遵守的规则示例代码注释与errCheck()校验逻辑共同印证源码见 heatmap_printer.go每个内层 slice 是一行data[0]是第一行data[1]是第二行以此类推矩阵必须矩形所有行的长度必须一致否则渲染报错data is not rectangular颜色按整个矩阵的最小/最大值缩放渲染前Srender()会调用minMaxFloat32heatmap_printer.go扫描全部单元格找出全局最小值与最大值作为后续颜色映射getColor分桶和 RGB 渐变Fade的边界。这意味着示例中最大的1与最小的-1.0分别对应色带的两端。数据不能为nil也不能为空对应错误data is nil/data is empty。数据类型固定为float32所以负值、小数、整数如示例中的1与0.0都可以直接放进矩阵。坐标轴HeatmapAxis 与长度匹配轴标签通过HeatmapAxis结构配置heatmap_printer.gotype HeatmapAxis struct { XAxis []string // 每个元素对应一列 YAxis []string // 每个元素对应一行 }示例中 13 个 X 标签a~m对应 13 列5 个 Y 标签1~5对应 5 行。标签数量必须与数据严格匹配否则渲染直接失败errCheck()会给出明确错误错误信息触发条件x axis is nil/y axis is nil对应轴标签未设置x axis is empty/y axis is empty标签切片为空x axis length does not match data某一行长度 ≠ XAxis 长度y axis length does not match dataYAxis 长度 ≠ 数据行数坐标轴标签会以HeatmapHeaderStyle默认FgLightCyan样式渲染在热力图的左侧首列Y 轴与底部末行X 轴。从测试用例TestHeatmapPrinter_GridAxisAndLegendLayoutheatmap_printer_test.go可见其布局Y 轴标签占据第一列X 轴标签位于最后一行左上角是空格。链式配置方法速查DefaultHeatmap已经预置了一组开箱即用的默认值heatmap_printer.goBoxed: true带边框、Grid: true带网格、Legend: true带图例、EnableRGB: false默认使用 ANSI 调色板。常用的 builder 方法如下方法作用备注WithData(data [][]float32)设置数据矩阵必填WithAxisData(hd HeatmapAxis)设置 X/Y 轴标签同时把HasHeader置为true标签长度须与数据匹配WithEnableRGB(b ...bool)开启 TrueColor RGB 渐变需要终端支持 TrueColorWithRGBRange(rgb ...RGB)自定义 RGB 渐变停靠点gradient stops只在 RGB 模式下生效WithColors(colors ...Color)自定义 ANSI 背景色调色板非 RGB 模式所有终端可用WithBoxed(b ...bool)开启/关闭外边框开启时若Grid为 false 会强制置为 trueheatmap_printer.goWithGrid(b ...bool)开启/关闭单元格间分隔线关闭时若开启着 Boxed 会连带关闭heatmap_printer.goWithLegend(b ...bool)显示/隐藏图例默认显示WithLegendLabel(s string)修改图例标题默认Legend调用后会自动打开图例WithLegendOnlyColoredCells(b ...bool)图例只显示色块、隐藏数值调用后会自动打开图例WithOnlyColoredCells(b ...bool)单元格只显示背景色、不打印数值可与WithCellSize搭配WithCellSize(i int)自定义单元格宽度仅无轴标签且OnlyColoredCells为 true 时生效heatmap_printer.goWithEnableComplementaryColor(b ...bool)为每个背景色自动配对互补前景色提升低端终端上的可读性WithTextColor(color Color)/WithTextRGB(rgb RGB)手动指定文字颜色设置后会关闭互补色所有With*方法都遵循 PTerm 的不可变构建风格在副本上修改并返回新实例原DefaultHeatmap不被改动Srender()是纯函数同一实例多次渲染结果一致且不会修改输入数据测试TestHeatmapPrinter_SrenderIsPure验证了这一点见 heatmap_printer_test.go。RGB 渐变着色的实现原理示例的核心亮点是WithEnableRGB()。它让单元格背景色从离散的 ANSI 调色板切换为平滑的 TrueColor 24 位渐变。默认 RGB 渐变范围默认范围定义在主题中theme.goHeatmapTextColor: FgBlack, HeatmapColors: []Color{BgRed, BgLightRed, BgYellow, BgLightYellow, BgLightGreen, BgGreen}, HeatmapTextRGB: RGB{0, 0, 0, false}, HeatmapRGBRange: []RGB{ {R: 255, G: 0, B: 0, Background: true}, // 红色 {R: 255, G: 165, B: 0, Background: true}, // 橙色 {R: 0, G: 255, B: 0, Background: true}, // 绿色 },也就是说默认 RGB 模式从红 → 橙 → 绿渐变最小值落在红色端、最大值落在绿色端。色值如何映射渲染单个单元格时sprintCell会根据EnableRGB分支heatmap_printer.goRGB 模式调用rgbStyleFor把单元格数值交给RGB.Fadergb.go插值到RGBRange的多个停靠点之间生成平滑渐变的背景色非 RGB 模式调用getColor把[min, max]区间等分成len(colors)个桶每个数值落进一个桶、取对应背景色heatmap_printer.go。最小值必然得到第一个颜色最大值必然得到最后一个颜色测试TestHeatmapPrinter_MinAndMaxValuesGetFirstAndLastColor用\x1b[41mBgRed与\x1b[42mBgGreen验证了这一点。RGB 模式还支持自定义渐变范围示例_examples/heatmap/custom_rgb/main.go用pterm.NewRGB(0, 0, 255)等构造了蓝→红→绿→黄的四个停靠点通过WithRGBRange(rgbRange...)注入。终端兼容性说明TrueColor 需要终端支持 24 位色如 iTerm2、现代 Windows Terminal。PTerm 在底层会做颜色级别适配不支持 TrueColor 的终端会自动把 RGB 降采样downsample到最接近的支持色内部实现见 internal/color/downsample.go。若想保证在所有终端包括 CI、老式终端下都稳定显示可放弃 RGB 模式改用WithColors(...)直接指定 ANSI 背景色——示例_examples/heatmap/custom_colors/main.go正是这样做的其注释明确说明Unlike RGB mode, this works in every terminal。互补色保证文字可读RGB 或 ANSI 背景色较深时默认黑色前景文字可能看不清。WithEnableComplementaryColor()会为每个背景自动计算互补前景色ANSI 模式查表complementaryColors见 heatmap_printer.goRGB 模式调用internal.Complementary在 RGB 空间求补色测试TestHeatmapPrinter_ComplementaryTextColorPerBucket验证 BgRed 配 FgCyan、BgGreen 配 FgMagenta见 heatmap_printer_test.go。图例Legend的生成逻辑默认配置会在热力图下方输出一个盒装图例╭──────┬───────...╮标题为Legend其数值从最小值到最大值线性均分legendValue把区间[min, max]按步数等分heatmap_printer.go。以示例数据min-1max1为例图例呈现-1 → -0.78 → -0.56 → … → 1的序列每格代表一段色带对应的数值区间。可调项WithLegendLabel(custom)把标题Legend换成任意文本示例_examples/heatmap/custom_legend/main.go使用WithLegendOnlyColoredCells()隐藏图例中的数值只留下纯色块在 RGB 模式下还会把图例变成更细密的平滑渐变步数 ×3、每格 1 字符宽见writeRGBLegendCellsheatmap_printer.goWithLegend(false)完全关闭图例。RGB 模式下图例的步数取max(len(RGBRange), 10)常量rgbLegendSteps 10见 heatmap_printer.go所以默认至少渲染 10 个渐变色块。实际渲染效果对照testdata/raw/heatmap_demo.txt保存了该示例的原始渲染输出可直观对照布局去掉颜色后的纯文本形式╭────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────┬────╮ │ 1 │ 0.9│ 0.2│-0.7│ 0.4│-0.5│ 0.6│-0.3│ 0.8│-0.1│ -1 │ 0.1│-0.8│ 0.3│ ├────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┤ │ 2 │ 0.2│-0.7│-0.5│-0.3│-0.1│ 0.1│ 0.3│ 0.5│ 0.9│-0.9│-0.7│-0.5│-0.3│ ├────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┤ │ 3 │ 0.4│ 0.4│-0.3│ -1 │ 0.3│-0.2│-0.9│ 0.5│-0.3│ -1 │ 0.6│-0.2│-0.9│ ├────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┤ │ 4 │ 0.9│-0.5│-0.1│ 0.3│ 1 │-0.7│-0.3│ 0.1│ 0.7│-0.9│-0.5│ 0.2│ 0.6│ ├────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┤ │ 5 │ 0.5│ 0.6│ 0.1│-0.2│-0.7│ 0.8│ 0.6│ 0.1│-0.5│-0.7│ 0.7│ 0.3│ 0 │ ├────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┼────┤ │ │ a │ b │ c │ d │ e │ f │ g │ h │ i │ j │ k │ l │ m │ ╰────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────╯ ╭──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────╮ │Legend│ -1 │ -0.78│ -0.56│ -0.33│ -0.11│ 0.11 │ 0.33 │ 0.56 │ 0.78 │ 1 │ ╰──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────╯几点观察列宽自适应columnWidth()heatmap_printer.go取数据值与所有轴标签的最大宽度本例数值多为 2~3 字符因此每列统一为 4 字符宽数值右对齐、单字符值居中padCell处理对齐-1、1、0这类短值会被居中/补齐heatmap_printer.go边框与网格盒装边框由writeGridLine绘制行间分隔线由writeRowSeparator绘制交叉点使用┼、┬、┴、├、┤等制表符分隔线样式由主题HeatmapSeparatorStyle默认FgGray控制图例盒图例本身也套了一个盒宽度略宽于单元格legendColWidth colWidth 2容纳-0.78这类小数。输入校验与常见错误所有渲染入口Srender()与Render()都会先经过errCheck()heatmap_printer.go校验失败会返回错误而非输出半成品。校验项包括数据非空、矩阵矩形、坐标轴非空、X/Y 轴长度与数据匹配。测试TestHeatmapPrinter_InputValidationheatmap_printer_test.go逐条覆盖了这些错误分支可作为排查问题时的对照表。调试时建议先调用Srender()检查error再决定是否打印。更多玩法同一数据的不同画法围绕同一份 5×13 数据矩阵_examples/heatmap/目录下的其他示例展示了HeatmapPrinter的更多变体可对照阅读custom_colorsWithColors(pterm.BgBlue, pterm.BgRed, ...)自定义 ANSI 调色板所有终端可用custom_legendWithLegendLabel(custom)WithLegendOnlyColoredCells()定制图例custom_rgbWithRGBRange(...)自定义四段 RGB 渐变no_gridWithGrid(false)去掉分隔线色块连成连续色面separatedWithBoxed(false)WithLegend(false)只保留单元格网格。结合仓库测试heatmap_printer_test.go 覆盖布局、图例、互补色、RGB 渐变与输入校验snapshot_test.go 生成 Heatmap 快照contract_test.go 验证Render()与Srender()输出一致你可以放心地把热力图嵌入自己的 CLI 工具并随时对照测试理解某个配置项的确切行为。小结PTerm 的HeatmapPrinter用一段不到 30 行的代码即可完成数据矩阵 → 彩色热力图的渲染HeatmapData[][]float32负责数据HeatmapAxis负责坐标轴标签WithEnableRGB()负责 TrueColor 平滑渐变。理解minMaxFloat32的全局缩放、getColor的分桶映射与Fade的插值逻辑就能精准预测每个数值在色带上的位置从而做出既美观又可读的终端热力图。安装 PTerm 只需在模块项目内执行go get github.com/pterm/pterm见根目录 README.md。赞分享开发工具【免费下载链接】pterm✨ PTerm is a modern Go module to easily beautify console output. Featuring charts, progressbars, tables, trees, text input, select menus and much more Its completely configurable and 100% cross-platform compatible.项目地址https://gitcode.com/gh_mirrors/pt/pterm点击查看免费下载相关推荐PTerm 热力图Heatmap终端渲染完全指南数据、坐标轴、配色与图例定制PTerm 热力图Heatmap终端渲染完全指南数据、坐标轴、配色与图例定制 本篇技术指南以 pterm 仓库中的 heatmap 示例文档 https:开发工具PTerm 热力图自定义 RGB 渐变色用 WithEnableRGB 与 WithRGBRange 打造专属配色终端图表PTerm 热力图自定义 RGB 渐变色用 WithEnableRGB 与 WithRGBRange 打造专属配色终端图表 本篇技术指南聚焦 Go 模块 PT开发工具PTerm RGB 渐变色渲染指南用 Fade 与 NewRGB 打造终端渐变文字PTerm RGB 渐变色渲染指南用 Fade 与 NewRGB 打造终端渐变文字 本篇技术指南围绕 PTerm 的 RGB 渐变色能力展开聚焦于 _exa开发工具上一篇用LiteGraph.js构建节点式UI路由概念的可视化实现下一篇使用 Jackson-Jaxb Codec在 Feign 中基于 JAXB 注解编解码 JSON创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考