如何用 Spectre.Console 快速渲染带样式的文本
Spectre.Console 的核心优势是「不用手动控制光标或 ANSI 转义序列就能输出颜色、对齐、边框」。最常用的是
AnsiConsole.Markup()和
AnsiConsole.Write()，它们支持类似 Markdown 的内联样式语法。
例如：
AnsiConsole.Markup("[bold red]错误[/]：文件 [underline]config.json[/] 未找到"); 会直接输出加粗红色文字 + 下划线路径，无需拼接 \u001b[1;31m这类转义码。
注意点：
[/]是必须的闭合标签，漏写会导致后续所有输出都被染色 不支持嵌套同类型标签（比如
[red][red]text[/][/]无效） 中文 Windows 默认终端（如 cmd）需启用 Virtual Terminal Processing（Win10+ 通常已默认开启；若乱码，先运行
reg add HKCU\Console /v VirtualTerminalLevel /t REG_DWORD /d 1）
怎么让表格自动适配宽度并支持分页
AsciiTable是最常用的布局组件，但它默认不会换行或截断长文本，容易撑破终端。关键在于设置
Table.Collapse()和列的
Overflow()行为。
示例：
var table = new Table()
.AddColumn(new TableColumn("Name").Overflow(Overflow.Ellipsis))
.AddColumn(new TableColumn("Status").Justify(Justify.Right))
.AddRow("VeryLongFileNameThatShouldBeTruncated.txt", "OK");
AnsiConsole.Write(table);
常见陷阱：
没调用.Collapse()→ 表格宽度按内容原始长度计算，可能超出终端宽度 列宽未设限制（如
.Width(20)）→
Overflow.Ellipsis不生效 分页需求强时，别硬塞几百行进一个
Table，改用
Pager组件包装
Renderable（比如把每页 20 行封装成独立
Panel）
进度条和实时刷新为什么卡住不动
Progress组件依赖后台线程推进，但如果你在主线程里同步执行耗时操作（比如
Thread.Sleep(2000)），UI 就会冻结——因为 Spectre.Console 的渲染器也在同一线程调度。
正确做法是用异步任务驱动进度：
await AnsiConsole.Progress()
.StartAsync(async ctx =>
{
var task1 = ctx.AddTask("加载配置");
await Task.Delay(800);
task1.Increment(50);
var task2 = ctx.AddTask("连接数据库");
await Task.Delay(1200);
task2.Increment(100);
});
关键约束：
必须用async/await，不能在
Start()（同步版）里调用阻塞 API 每个
task.Increment()后会触发一次重绘，频繁调用（如循环中每毫秒一次）会导致 CPU 暴涨，建议最小增量 ≥ 1%，或用
task.Value = x手动设值 如果任务本身不支持 async（如旧 SDK 的同步 HTTP 调用），需包裹进
Task.Run()，但要注意避免 UI 线程被抢占
如何在日志输出中混入 Spectre.Console 样式
Spectre.Console 本身不是日志框架，它不接管
Console.WriteLine。想让
Microsoft.Extensions.Logging输出带样式的日志，得自己写
ILoggerProvider或用现成的
Spectre.Console.Extensions.Logging包。
安装后只需两行：
var loggerFactory = LoggerFactory.Create(cfg => {
cfg.AddSpectreConsole(); // 替换默认 ConsoleLogger
});
但要注意：
该扩展默认只对LogInformation及以上级别生效，
LogDebug需显式配置
.MinimumLevel.Debug()样式映射是静态的（如 Error → red，Warning → yellow），无法按日志内容动态变色（比如含 “timeout” 就标红），这种需求得自己继承
ConsoleLogger并重写
WriteMessage如果项目同时用了 Serilog 或 NLog，别直接 AddSpectreConsole，应通过其 Sink 机制对接（如
Serilog.Sinks.SpectreConsole）
真正难的不是加颜色，而是让样式在不同环境（CI 日志、重定向到文件、Windows Terminal vs PowerShell）下保持一致——多数问题出在终端能力检测失败，建议初始化时强制
AnsiConsole.Settings.OutputMode = OutputMode.TrueColor;并关闭自动探测。
