Altair坐标轴标签配置：format与labelExpr的行为差异问题

核心执行逻辑 #

所有异常行为均来自对底层Vega-Lite轴标签生成管线的流程误解，不存在API设计偏差：

• 轴标签生成的默认流程为：计算刻度位置→获取刻度对应的原始数值→调用format属性的规则将数值转为格式化字符串→将结果渲染为标签。
• 只要在轴配置中设置了labelExpr，整个默认流程会被截断：Vega-Lite只会把刻度点的上下文数据传给表达式，完全跳过内置的format格式化步骤，不管你是否在同个Axis节点上声明了format参数，该参数都不会对最终标签产生任何效果。

datum上下文字段定义 #

• datum.value：当前刻度位置对应的原始未格式化的数值。在线性、对数尺度下行为完全一致，你观测到对数尺度下返回值异常，本质是对数尺度默认的主/次刻度配置规则——默认仅展示10的整数次幂的主刻度标签，次刻度仅显示短标记不渲染标签，当开启次刻度标签后，所有次刻度点的datum.value都是对应真实刻度值，不存在逻辑差异。
• datum.label：在调用labelExpr之前，由内置format管线生成的、已经格式化完成的标签字符串，本质是文本而非数值。

复现代码中的效果差异来源 #

逐行对应测试的4个示例：

• 直接使用axis=alt.Axis(format='~s')：走完整默认格式化流程，将数值转为带SI量级后缀（k/M/G）的紧凑格式，符合预期。
• labelExpr="format(datum.value,'~s')+' ppm'"：跳过内置格式化流程，手动在表达式中对原始数值datum.value调用格式化函数处理后追加后缀，效果和默认格式化基本一致，仅存在不同渲染版本下的微小精度差异。
• labelExpr="datum.value +' ppm'", format='~s'：跳过内置格式化流程，直接把原始大整数和字符串拼接，format='~s'完全不生效，所以显示为超长未格式化数字。
• labelExpr="datum.label +' ppm'", format='~s'：先靠内置format管线生成格式化好的文本存在datum.label中，再在表达式中拼接后缀，效果符合预期。
• labelExpr="format(datum.label, '~s') +' ppm'"：把已经是字符串的datum.label传给仅接受数值输入的format()函数，触发类型不匹配的非预期转换。

推荐的正确用法 #

1. 需求为「在标准数字格式后追加固定字符串后缀」时，优先利用datum.label的现有格式化结果，避免重复写格式化逻辑，代码示例：

   alt.Y(
       'y:Q',
       scale=alt.Scale(type='log'),
       axis=alt.Axis(
           format='~s',
           labelExpr="datum.label + ' ppm'"
       )
   )
   

   该写法在线性、对数尺度下均能稳定生效，不会出现字段逻辑不一致的问题。
2. 需求为「完全自定义数字格式规则」时，直接基于原始值datum.value在表达式中实现逻辑，此时无需额外声明轴的format参数，避免逻辑冲突。
3. 对数尺度下需要自定义次刻度标签时，开启minorTicks配置，所有主、次刻度的datum.value取值逻辑和线性尺度完全一致。

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