使用HarfBuzz时字形垂直对齐（bearing y）异常问题排查

结论先行 #

HarfBuzz完全支持bearing y相关的垂直对齐计算，你的问题属于实现环节的疏漏，而非库本身的限制。

关键错误点分析 #

• 未正确应用字形的y_bearing/y_offset数据：
  HarfBuzz排版后会输出包含y_bearing（基线到字形顶部的偏移）和y_offset的字形定位信息，如果你的渲染代码只处理了x方向的偏移与推进量，完全忽略y轴相关字段，就会导致所有字形都贴在基线位置，像破折号这类基线不在自身中心的字符自然无法居中。
• 未计算文本整体垂直范围：
  要实现Hb View的居中效果，你需要先遍历所有字形，算出文本的整体垂直边界（从最小的y_bearing到最大的y_bearing + 字形高度），再通过整体偏移让文本块与目标区域垂直居中——仅依赖单个字形的偏移是不够的。
• 定位数据提取不完整：
  检查你的代码是否正确调用hb_buffer_get_glyph_positions获取了完整的位置数据，若只读取x方向字段，自然会出现所有字形y_offset为0的异常。

修复步骤建议 #

1. 补全Y轴定位逻辑：在渲染每个字形时，将HarfBuzz返回的y_bearing和y_offset纳入Y坐标计算，公式参考：渲染Y = 基线Y + y_offset + y_bearing。
2. 计算整体垂直偏移：遍历所有字形，统计文本的顶部边界（最小y_bearing）和底部边界（最大y_bearing + 字形高度），然后计算让文本块居中的偏移量：垂直居中偏移 = (目标区域高度 - 文本总高度) / 2 - 顶部边界。
3. 验证特殊字符数据：单独打印破折号字形的y_bearing和高度值，确认HarfBuzz已返回正确的垂直定位参数，再对应调整渲染坐标。

内容的提问来源于stack exchange，提问作者Lyhokia