如何用Python的python-pptx通过数据字典替换PPT图表文本标签？

已实现PPT文本框的标签替换逻辑，但处理图表时，series.values仅返回数值类型数据，文本类标签无法被识别（输出全为0）。以下是针对不同场景的解决方案，实现遍历PPT并通过数据字典替换图表内标签值的目标：

核心问题说明 #

series.values仅适配数值型数据系列，文本类标签（如分类轴文本、系列名称、数据标签文本）需要通过对应属性访问，而非直接调用series.values。

分场景解决方案 #

1. 替换分类轴（X轴）标签 #

如果待替换的标签是图表分类轴的文本，直接操作图表数据源的分类集合：

for slide in prs.slides:
    for shape in slide.shapes:
        if shape.has_chart:
            chart = shape.chart
            chart_data = chart.chart_data
            # 遍历所有分类轴标签
            for idx, category in enumerate(chart_data.categories):
                tag = category.strip()
                if tag in df.iloc[:,0].values:
                    # 从数据字典匹配对应值
                    row_idx = df[df.iloc[:,0] == tag].index[0]
                    new_value = str(df.iloc[row_idx, 1])
                    chart_data.categories[idx] = new_value
            # 刷新图表数据源
            chart.chart_data = chart_data

2. 替换图表系列名称（图例文本） #

如果标签是图例中的系列名称，直接修改系列的name属性：

for slide in prs.slides:
    for shape in slide.shapes:
        if shape.has_chart:
            chart = shape.chart
            chart_data = chart.chart_data
            for series in chart_data.series:
                tag = series.name.strip()
                if tag in df.iloc[:,0].values:
                    row_idx = df[df.iloc[:,0] == tag].index[0]
                    new_value = str(df.iloc[row_idx, 1])
                    series.name = new_value
            chart.chart_data = chart_data

3. 替换数据点的文本标签 #

如果标签是图表数据点上方/旁侧的文本标签，遍历数据标签对象修改：

for slide in prs.slides:
    for shape in slide.shapes:
        if shape.has_chart:
            chart = shape.chart
            for series in chart.series:
                if series.has_data_labels:
                    for label in series.data_labels:
                        tag = label.text.strip()
                        if tag in df.iloc[:,0].values:
                            row_idx = df[df.iloc[:,0] == tag].index[0]
                            new_value = str(df.iloc[row_idx, 1])
                            label.text = new_value

4. 替换文本型数据系列的值 #

如果图表包含纯文本类型的数据系列（如某些特殊图表的文本数据），直接修改数据源的系列值：

for slide in prs.slides:
    for shape in slide.shapes:
        if shape.has_chart:
            chart = shape.chart
            chart_data = chart.chart_data
            for series in chart_data.series:
                # 遍历系列的每个数据项
                for idx, value in enumerate(series.values):
                    tag = str(value).strip()
                    if tag in df.iloc[:,0].values:
                        row_idx = df[df.iloc[:,0] == tag].index[0]
                        new_value = str(df.iloc[row_idx, 1])
                        series.values[idx] = new_value
            chart.chart_data = chart_data

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