rich1e
0.13D

为什么 ASCII 线框图(Wireframe)一出现中文就对不齐?是字体问题,还是 Unicode 字符宽度导致的?

  •  
  •   rich1e · Jul 3 · 2104 views
    This topic created in 138 days ago, the information mentioned may be changed or developed.

    最近在用 AI 生成 ASCII 线框图时,发现只要内容里出现中文,就很容易出现对齐问题。

    例如:

    +---------------+
    |  /Lesson      |
    |  事後回顧      |
    +---------------+
    

    理论上,两行内容都是从同一列开始,但实际在很多终端、Markdown 编辑器或代码编辑器中显示时,视觉上却没有垂直对齐。

    查了一些资料后,大概了解到原因主要有几点:

    • ASCII 字符通常属于半角字符(宽度为 1 )。
    • 中文、日文、韩文( CJK )字符通常属于全角字符(宽度约为 2 )。
    • 不同字体、终端和 Markdown 渲染器,对 CJK 字符宽度的处理并不完全一致。
    • 有些编辑器虽然英文使用等宽字体,但中文会自动回退到非等宽字体,因此即使字符宽度理论正确,显示效果仍然会错位。

    目前看到的几种解决方案包括:

    • 使用支持 CJK 的等宽字体,例如 Sarasa Mono 、Maple Mono 、LXGW Mono 等。
    • 程序生成 ASCII 图时,不使用 len() 计算字符串长度,而是使用 wcwidth 、string-width 等库计算字符显示宽度。
    • 使用 Unicode Box Drawing (┌ ─ │ ┘)代替传统 ASCII (+ - |)。
    • 如果需要展示中英文混排的结构图,考虑改用 Mermaid 、Markdown Table 、HTML 或 SVG ,而不是 ASCII 图。

    我发现使用 Maple Mono 字体,是一个非常简单有效的方案。 如下:

    另外,想请教一下大家:

    1. 大家在日常开发中遇到过类似的问题吗?
    2. 有没有哪个终端、编辑器或字体,对 CJK 的等宽显示支持得比较好?
    3. 如果需要生成可跨平台展示的文本线框图,目前有没有比较成熟的最佳实践?

    欢迎分享你的经验或踩过的坑!

    4 replies  •  2026-11-14 17:04:52 +08:00
    xy2401
    xy2401
    Jul 3
    1
    用过 markdown 写表格 就应该知道这个问题
    还涉及到 chrome / electron 的渲染问题
    我直接选择放弃
    rich1e
    rich1e
    OP
    Jul 3
    2
    @xy2401 换个字体或许就可以解决。亲测 vscode 、obsidian 和 iTerm 有效果。

    archxm
    archxm
    Jul 3
    3
    字体问题,之前也遇到了。也是处理 markdown 的表格对齐时。
    Asaxix
    Asaxix
    3 days ago
    4
    UnitsPerEm (UPM):字体的设计网格精度( TrueType 通常为 1000 或 2048 )。
    Advance Width (步进宽度):光标渲染完该字符后向右移动的总距离(左侧距+宽度+右侧距)。

    以 Ubuntu Sans Mono 为例:
    'A'对应的字形
    步进宽度 560
    网格精度 1000
    比例系数 560/1000 = 0.56 Em ,占据 0.56 宽度的 Em 框(正方形框)
    字号 16px ,意味着宽度 16 像素,也就是 Em 框宽度
    屏幕实际像素宽度 = 比例系数 * 当前字号,也就是渲染该字形后光标向右移动距离

    中英文对齐,理想的情况是中英(全半)字形步进宽度比例为 2:1 ,这样可以保证左对齐时距行首距离都是英文字形宽度的整数倍。

    Sarasa Mono SC:
    '汉'对应字形:
    步进宽度 1000
    网格精度 1000
    比例系数 1000/1000 = 1 Em

    首选 Ubuntu Sans Mono ,备选 Sarasa Mono SC 时,中英字符步进宽度比 1:0.56 ,导致无法对齐。
    Terminal 可以对齐是因为按照固定列宽网格渲染的,半角占 1 格,全角占 2 格。

    解决方案就很简单了,2:1 就行。
    1. 全部使用 Sarasa Mono SC 这种 2:1 的字体,缺点:连续半角视觉上太拥挤
    2. 英文步进宽度迁就中文,实际上与方案 1 没区别,且相邻字形可能重叠
    3. 中文迁就英文,以上述为例:

    Ubuntu Sans Mono 半角 560/1000 ,不动
    Sarasa Mono SC 全角 1000/1000 ,步进宽度改为 1120/1000
    使用 python fontTools.ttLib 改原步进宽度 1000 为 1120 ,居中

    实际使用体验,Terminal 没区别,等宽渲染是对齐的,ASCII 线框图也是对齐的。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   4329 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 44ms · UTC 08:20 · PVG 16:20 · LAX 00:20 · JFK 03:20
    ♥ Do have faith in what you're doing.