如何使用xlwings为Excel图表的Series添加自定义数据标签

在Windows环境下进行自动化图表报告分析时，需要通过xlwings为已创建的Excel散点图的SeriesCollection或FullSeriesCollection添加自定义数据标签（以ID列作为每个数据点的标签）。尝试过VBA录制器方法、直接赋值DataLabels、调用ApplyDataLabels()均无法得到预期效果，目前仅能通过循环逐个赋值实现，寻求规范的解决方案。

现有尝试代码 #

# 创建图表
chart = sheet.charts.add() 
chart.chart_type = 'xy_scatter_lines' 
chart.api[1].SeriesCollection().NewSeries() 

# 假设已有数据
x = data_p_sheet.range(f'{col_x}5').expand("down")
y = data_p_sheet.range(f'{col_y}5').expand("down")
chart.api[1].SeriesCollection(1).XValues = x.api
chart.api[1].SeriesCollection(1).Values = y.api 
chart.api[1].FullSeriesCollection(1).Name = "MyChart"

labels = data_p_sheet.range(f'{col_labels}5').expand("down") 
chart.api[1].FullSeriesCollection(1).DataLabels = labels

chart.api[1].FullSeriesCollection(i).ApplyDataLabels() 

# 仅能通过循环实现的方式
for i, label in enumerate(labels):
    i_label = chart.api[1].SeriesCollection(j).DataLabels(i+1)
    i_label.Text = str(label)

规范解决方案 #

可以利用Excel对象模型中DataLabels.Range的批量赋值能力，避免循环，实现高效的自定义标签设置，步骤如下：

1. 先调用ApplyDataLabels()并配置参数，关闭默认的X/Y值标签，确保仅显示自定义内容
2. 通过DataLabels.Range.Value直接将ID列数据批量赋值给所有数据标签

修改后的代码 #

# 创建图表
chart = sheet.charts.add() 
chart.chart_type = 'xy_scatter_lines' 
chart.api[1].SeriesCollection().NewSeries() 

# 绑定数据
x = data_p_sheet.range(f'{col_x}5').expand("down")
y = data_p_sheet.range(f'{col_y}5').expand("down")
series = chart.api[1].FullSeriesCollection(1)
series.XValues = x.api
series.Values = y.api 
series.Name = "MyChart"

# 获取标签数据
labels = data_p_sheet.range(f'{col_labels}5').expand("down") 

# 启用数据标签并关闭默认显示项
series.ApplyDataLabels(
    ShowSeriesName=False,
    ShowCategoryName=False,
    ShowValue=False,
    ShowLegendKey=False
)

# 批量赋值自定义标签
series.DataLabels.Range.Value = labels.value

关键说明 #

• 直接赋值DataLabels属性无效，因为DataLabels是对象集合，需通过其Range属性来批量设置文本内容
• ApplyDataLabels()的参数配置可以避免默认标签（如数值、系列名）干扰自定义标签的显示
• 利用Range.Value批量赋值比循环逐个设置效率更高，尤其在数据点较多时更明显

内容的提问来源于stack exchange，提问作者G.nino