Figgle：在控制台中打印 ASCII 艺术字

Wed, 22 Jul 2026 00:00:00 +0000

我的一些 C# 的教学视频里经常会用到一种看起来很华丽的 ASCII 艺术字，形如：

1
2
3
4
5
6
7
8


 _____ _____ _ 
 / ____|/ ____| | 
| | | (___ | |__ __ _ _ __ _ __ 
| | \___ \| '_ \ / _` | '__| '_ \
| |____ ____) | | | | (_| | | | |_) |
 \_____|_____/|_| |_|\__,_|_| | .__/
 | | 
 |_|

或者

1
2
3
4
5
6
7
8
9


 ____ ____ __ 
/\ _`\ /\ _`\ /\ \ 
\ \ \/\_\\ \,\L\_\ \ \___ __ _ __ _____ 
 \ \ \/_/_\/_\__ \\ \ _ `\ /'__`\ /\`'__\/\ '__`\
 \ \ \L\ \ /\ \L\ \ \ \ \ \/\ \L\.\_\ \ \/ \ \ \L\ \
 \ \____/ \ `\____\ \_\ \_\ \__/.\_\\ \_\ \ \ ,__/
 \/___/ \/_____/\/_/\/_/\/__/\/_/ \/_/ \ \ \/
 \ \_\
 \/_/

经常会有观众问我这样的文字是怎么生成的。其实很简单，我用了 Figgle 这个 NuGet 库。

Figgle 是一个用于在 .NET 程序中生成 ASCII 艺术字横幅的开源库。给它一段普通文本和一种字体，它就能将文本渲染成上面那样由普通字符组成的“大字”。它很适合用在命令行工具的启动 Banner、示例程序的标题，或者需要在终端里突出显示某些信息的场景。

Figgle 的名字和能力都来自更早的 FIGlet 项目。FIGlet 是一个经典的命令行程序，最早由 Glenn Chappell 在 1991 年编写；它使用 .flf 字体文件，将文本转换为 ASCII 艺术字。此后，社区积累了大量不同风格的 FIGlet 字体。

Figgle 将这种成熟的字体格式和渲染方式带到了 .NET 生态中。它并不是自己定义一套新的艺术字格式，而是负责解析 FIGlet 字体并输出渲染结果。因此，Figgle 既可以使用它提供的现成字体，也可以使用自己找到或制作的 .flf 字体文件。

Figgle 的几个 NuGet 包

Figgle 项目目前主要发布了三个 NuGet 包，它们分别面向不同的使用方式。

`Figgle`

Figgle 是核心包，负责解析 FIGlet 字体和渲染文本。它不包含完整的字体集合，因此包本身比较轻量。

如果项目中使用的是自定义 .flf 文件，或者通过源生成器把字体嵌入到了自己的程序集里，运行时通常只需要引用这个包。

`Figgle.Fonts`

Figgle.Fonts 是字体包，内置了 250 多种 FIGlet 字体（截止到写这篇文章时的 0.6.6 版本，共有 265 种字体）。最简单的使用方式就是同时安装 Figgle 和它，然后通过 FiggleFonts 类取得某一种预置字体。

1
2


dotnet add package Figgle
dotnet add package Figgle.Fonts

后面会看到，诸如 Standard、Slant、Graffiti 等常用字体，都是由这个包提供的。它适合快速尝试不同的效果；代价是应用会携带完整字体集。

`Figgle.Generator`

Figgle.Generator 是一个 C# 源生成器包，主要用来优化发布体积和运行时开销。

它有两种典型用法：对于编译期就确定的文本，直接在编译时生成最终的 ASCII 字符串；对于运行时才确定的文本，则只将实际会用到的字体嵌入程序集。这样就无需在最终应用中携带完整的 Figgle.Fonts 字体包。

Note

如果只是想在小型控制台项目里快速打印一个标题，直接使用 Figgle 和 Figgle.Fonts 就足够了。Figgle.Generator 更适合在意应用体积，或只需要少数几个固定字体的场景。

使用 Figgle 和 Figgle.Fonts

对于大多数控制台程序而言，直接引用 Figgle 与 Figgle.Fonts 是最简单的方式。前者提供渲染能力，后者提供预置字体；安装命令在上文已经列出。

安装完成后，在代码中引入 Figgle 命名空间，即可通过 FiggleFonts 访问字体。下面的示例使用默认的 Standard 字体，将普通字符串渲染为 ASCII 艺术字：

1
2
3


using Figgle;

Console.WriteLine(FiggleFonts.Standard.Render("Hello, World!"));

Render 方法接收需要显示的文本，返回一个包含换行符的字符串。

Figgle.Fonts 内置了 250 多种字体。不同字体的高度、宽度和风格差异很大，只要更换 FiggleFonts 上的字体属性，就能得到完全不同的效果。

例如，Slant 字体会让字符呈现倾斜效果，而 ThreePoint 字体非常紧凑，适合控制台宽度有限，或者不希望 Banner 占用太多行的场景。

1
2
3
4


using Figgle;

Console.WriteLine(FiggleFonts.Slant.Render("Figgle"));
Console.WriteLine(FiggleFonts.ThreePoint.Render("Figgle"));

Tip

在选择字体时，建议同时考虑终端窗口的宽度和文本长度，并务必使用等宽字体（常见的有 Consolas、Courier New、Monaco 等），否则 ASCII 艺术字的对齐会被破坏。另外，Figgle 只支持 ASCII 字符，也就是英文字母、数字和常用符号；中文或其他非 ASCII 字符无法渲染。

使用 Figgle.Generator

直接引用 Figgle.Fonts 很方便，但它会将全部 265 种字体一并带入应用。对于只使用一个固定 Banner 的程序，这显然有些浪费。Figgle.Generator 是一个 C# 源生成器：它会在编译时读取字体并生成 C# 代码，让最终程序只保留真正需要的内容。

根据文本是否在编译时确定，源生成器有两种用法。

在编译期生成固定文本

如果 Banner 的内容固定，例如程序名称或版本标题，可以让源生成器直接将最终的 ASCII 字符串写入程序集。此时运行时不需要 Figgle 或 Figgle.Fonts。

先安装源生成器。PrivateAssets="all" 表示该包只在编译期使用，不会作为依赖传递给引用当前项目的其他项目：

1
2
3


<ItemGroup>
 <PackageReference Include="Figgle.Generator" Version="0.6.6" PrivateAssets="all" />
</ItemGroup>

然后为一个 partial 类添加 GenerateFiggleText 特性：

1
2
3
4
5
6
7


using Figgle;

[GenerateFiggleText(
 memberName: "Title",
 fontName: "slant",
 sourceText: "My Application")]
internal static partial class AsciiBanners;

编译时，源生成器会在 AsciiBanners 中生成名为 Title 的静态成员。使用时直接读取它即可：

1

Console.WriteLine(AsciiBanners.Title);

这里的 fontName 使用的是 FIGlet 字体名称，而不是 FiggleFonts.Slant 这样的 C# 属性名。字体名不区分大小写。

嵌入字体并在运行时渲染

如果需要渲染的文本直到运行时才能确定，例如将用户输入、服务器名称或当前环境名称输出为艺术字，就不能预先生成最终字符串。不过仍然可以只嵌入一个需要的字体。

这种方式需要在运行时引用核心包，并在编译期引用源生成器：

1
2
3
4


<ItemGroup>
 <PackageReference Include="Figgle" Version="0.6.6" />
 <PackageReference Include="Figgle.Generator" Version="0.6.6" PrivateAssets="all" />
</ItemGroup>

使用 EmbedFiggleFont 特性声明要嵌入的字体：

1
2
3
4
5
6


using Figgle;

[EmbedFiggleFont(
 memberName: "Slant",
 fontName: "slant")]
internal static partial class EmbeddedFonts;

编译后会得到一个 FiggleFont 对象，因此可以像普通字体一样在运行时调用 Render：

1
2


string environmentName = Environment.MachineName;
Console.WriteLine(EmbeddedFonts.Slant.Render(environmentName));

最终应用只会包含 Figgle 核心库和 slant 字体，不再依赖完整的 Figgle.Fonts 包。

Tip

固定文本优先使用 GenerateFiggleText，因为它连运行时渲染和核心库都不需要；只有在文本动态变化时，才选择 EmbedFiggleFont。

常用字体推荐

虽然 FiggleFonts 里面包含了大量的字体，但其实个人觉得 90% 以上的都完全用不上，或者可读性非常差。所以这里我挑选了一些个人向的常用字体，供大家参考。下面的例子都以“Figgle”为例。

Big

1
2
3
4
5
6
7
8


 ______ _ _ 
| ____(_) | | 
| |__ _ __ _ __ _| | ___
| __| | |/ _` |/ _` | |/ _ \
| | | | (_| | (_| | | __/
|_| |_|\__, |\__, |_|\___|
 __/ | __/ | 
 |___/ |___/ 

此外，Standard、Doom、IVrit 都与此类似，只是细节和大小上略有差异。

Slant

1
2
3
4
5
6
7



 _______ __ 
 / ____(_)___ _____ _/ /__ 
 / /_ / / __ `/ __ `/ / _ \
 / __/ / / /_/ / /_/ / / __/
 /_/ /_/\__, /\__, /_/\___/ 
 /____//____/ 

Ogre

1
2
3
4
5
6


 ___ _ _ 
 / __(_) __ _ __ _| | ___ 
 / _\ | |/ _` |/ _` | |/ _ \
/ / | | (_| | (_| | | __/
\/ |_|\__, |\__, |_|\___|
 |___/ |___/ 

Larry3d

1
2
3
4
5
6
7
8
9


____ ___ 
/\ _`\ __ /\_ \ 
\ \ \L\_\/\_\ __ __ \//\ \ __ 
 \ \ _\/\/\ \ /'_ `\ /'_ `\ \ \ \ /'__`\ 
 \ \ \/ \ \ \/\ \L\ \/\ \L\ \ \_\ \_/\ __/ 
 \ \_\ \ \_\ \____ \ \____ \/\____\ \____\
 \/_/ \/_/\/___L\ \/___L\ \/____/\/____/
 /\____/ /\____/ 
 \_/__/ \_/__/ 

预览全部字体

如果大家还拿不定主意，那么可以用下面这个 C# 脚本来快速预览所有字体。使用 .NET 10 新增的 dotnet run app.cs 即可。如果版本比较低，只需要把它改成一个传统的 C# 控制台项目即可。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


#:package Figgle.Fonts@0.6.6 // 它依赖 Figgle，会自动引入

using System.Reflection;
using Figgle;
using Figgle.Fonts;

var fonts = typeof(FiggleFonts)
 .GetProperties(BindingFlags.Public | BindingFlags.Static)
 .Where(p => p.PropertyType == typeof(FiggleFont))
 .Select(p => new { p.Name, Font = (FiggleFont)p.GetValue(null)! })
 .ToArray();

Console.Write("Enter text to render: ");
var input = Console.ReadLine();

foreach (var font in fonts)
{
 Console.WriteLine($"Font: {font.Name}");
 Console.WriteLine(font.Font.Render(input));
 Console.WriteLine();
}

console on 寒流の编程笔记

Figgle：在控制台中打印 ASCII 艺术字

Figgle 的几个 NuGet 包

Figgle

Figgle.Fonts

Figgle.Generator

使用 Figgle 和 Figgle.Fonts

使用 Figgle.Generator

在编译期生成固定文本

嵌入字体并在运行时渲染

常用字体推荐

Big

Slant

Ogre

Larry3d

预览全部字体

`Figgle`

`Figgle.Fonts`

`Figgle.Generator`