VSCode运行Altair绘图代码仅返回LayerChart对象无法显示图表

Altair本身不会直接生成静态图片，它的输出本质是符合Vega-Lite规范的JSON结构声明，需要对应前端渲染器解析这份声明才能绘制出可视化图表。
仅输出alt.LayerChart(...)字符串、不渲染图表的核心原因，是当前VSCode的Python运行环境没有配置对应的Vega-Lite渲染解析能力，直接执行脚本时只会把Python对象的默认字符串表示打印到输出面板，不会触发图表渲染逻辑。

根据你使用的VSCode运行场景，选择对应方案即可：

• 如果你用Jupyter交互式笔记本（.ipynb文件）写代码
  先安装渲染依赖：在终端执行命令 pip install vega vega-datasets，安装完成后重启Python内核，保持图表对象为单元格最后一行的返回值，即可自动渲染图表。如果仍不显示，在导入altair后添加一行配置：

  alt.renderers.enable('mimetype')
  

  该配置会让Altair直接输出标准Vega-Lite MIME类型数据，VSCode内置的Notebook渲染组件原生支持解析该格式出图。
• 如果你运行的是普通.py脚本文件
  普通脚本运行模式不会自动捕获变量返回值做富媒体渲染，有两种可选方案：
  1. 在代码末尾添加.show()方法调用，修改后的完整代码如下：

  import numpy as np
  import pandas as pd
  import altair as alt
  df = pd.DataFrame({"x1": [0, 2], "y1":[8, 3], "x2": [0.5, 2], "y2": [0, 3]})
  equation1 = alt.Chart(df).mark_line().encode(x="x1", y="y1")
  equation2 = alt.Chart(df).mark_line(color="red").encode(x="x2", y="y2")
  (equation1 + equation2).show()
  

  执行后Altair会自动唤起系统默认浏览器，打开包含交互图表的本地临时页面。
  2. 直接将图表导出为本地HTML文件，之后双击文件即可在浏览器查看：

  (equation1 + equation2).save("double_line_chart.html")
  

注意：不要在普通.py脚本的输出面板里期待直接显示Altair交互图表，VSCode的普通Python脚本输出面板仅支持纯文本输出，没有内置Vega-Lite解析能力，必须通过浏览器打开HTML、或是在交互式Notebook环境中才能正常渲染交互图表。

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