Altair绘制堆叠条形图时X轴显示undefined数据归入同一柱形

Altair渲染时X轴全显示undefined、所有数据堆叠到单根柱形，是典型的编码字段和DataFrame实际列不匹配导致的问题：

• Altair的图表渲染分为Python端生成规约、前端Vega-Lite渲染两个环节，当你在x编码里写的字段名在传入的DataFrame中找不到时，Python端不会抛出报错，前端会把所有样本的该字段值识别为空值，最终统一归到undefined分类下。
• 你提到手动将parameters.tab_name转为字符串类型没有解决问题，基本可以排除字段类型不匹配的诱因，问题出在字段名识别环节：要么是你写在编码里的列名和DataFrame实际列名存在拼写、大小写、前后空格的差异，要么是列名包含.这类特殊字符时没有做转义——Altair默认会把字段名里的.识别为嵌套属性访问符，不会把它当作列名的一部分。
• 低概率诱因是本地安装的Altair版本过旧，存在pandas分类/字符串列的解析兼容bug。

按优先级依次排查即可：

1. 校验列名一致性
   在绘图代码前执行以下代码，打印DataFrame的全部列名，和你写在alt.X()里的字段名做逐字符比对，重点检查隐形空格、大小写差异：

   print(your_dataframe.columns.tolist())
   

   如果你的X轴列名本身包含.（比如列名就是parameters.tab_name），不要直接写x='parameters.tab_name:N'，需要用方括号包裹列名转义特殊字符，正确写法如下：

   alt.Chart(your_dataframe).mark_bar().encode(
       x=alt.X('[parameters.tab_name]:N', title='Tab分类'),
       y=alt.Y('count():Q', title='数量'),
       color='用户名:N'
   )
   

2. 校验字段实际值
   列名匹配后，执行代码打印目标列的样本值，确认字段本身没有被意外覆盖为全空/单值：

   print(your_dataframe['你的X轴列名'].unique())
   

   正常应该输出你预期的6个分类值，如果输出全为nan，说明你之前做数据处理时意外覆盖了该列的内容。
3. 版本兼容修复
   前两步都没有问题的话，执行以下命令升级Altair到最新稳定版，重启Jupyter内核后重新运行代码即可：

   pip install --upgrade altair
   

注意：Altair的编码规则只会读取你传入alt.Chart()的DataFrame内部列，不会读取Python环境中单独定义的外部变量，不要把独立的变量名和DataFrame列名混淆。

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