使用openpyxl编辑Excel多图表时遇索引越界错误的解决问询

问题场景 #

我用openpyxl编辑Excel图表，工作中图表类型和数据各不相同，但公司有统一的格式与字体要求。当前代码处理第一个图表（用ws._charts[0]）有效，但尝试编辑第二个图表（ws._charts[1]）时出现索引越界错误，希望实现编辑第二个及更多图表的功能。

原代码 #

def graph_formatting(file, font_style = 'Times New Roman', fill_color = "000000"):
    wb = opyxl.load_workbook(file)
    allSheetNames = wb.sheetnames
    ws = wb.active #renders it active
    dechart = ws._charts[1] #the problematic code. 
    print(allSheetNames)
    font_test = Font(typeface=font_style)
    cp = CharacterProperties(latin=font_test, sz=1500)
    dechart.x_axis.txPr = RichText(
            p=[Paragraph(
                 pPr=ParagraphProperties(defRPr=cp), 
                 endParaRPr=cp)
            ])

    dechart.x_axis.graphicalProperties.line.solidFill = fill_color #changes the line color
    dechart.y_axis.graphicalProperties.line.noFill = False #draws the y axis line
    dechart.y_axis.majorGridlines = None #gets rid of gridline
    dechart.y_axis.majorTickMark = 'out' #create tickmarks for x and y axis
    dechart.x_axis.majorTickMark = 'out'
    dechart.title ='' #deletes the chart title 

    #wb.save(path)
    wb.save(file)

问题原因 #

索引越界的核心原因是当前活动工作表中的图表数量少于你指定的索引值——比如工作表只有1个图表，却硬要取索引为1的元素（索引从0开始），自然会报错。直接写死索引的方式非常不灵活，适配不了不同工作表的图表数量差异。

解决方案 #

方案1：批量处理所有图表（推荐）

直接遍历工作表中的所有图表，统一应用格式，不管有多少个图表都能处理，彻底避免索引问题：

def graph_formatting(file, font_style='Times New Roman', fill_color="000000"):
    import openpyxl as opyxl
    from openpyxl.drawing.text import Font, CharacterProperties, RichText, Paragraph, ParagraphProperties

    wb = opyxl.load_workbook(file)
    ws = wb.active
    charts = ws._charts  # 获取当前工作表所有图表
    
    if not charts:
        print("当前工作表没有图表")
        return
    
    # 遍历所有图表，统一应用格式
    for dechart in charts:
        font_test = Font(typeface=font_style)
        cp = CharacterProperties(latin=font_test, sz=1500)
        dechart.x_axis.txPr = RichText(
                p=[Paragraph(
                     pPr=ParagraphProperties(defRPr=cp), 
                     endParaRPr=cp)
                ])

        dechart.x_axis.graphicalProperties.line.solidFill = fill_color
        dechart.y_axis.graphicalProperties.line.noFill = False
        dechart.y_axis.majorGridlines = None
        dechart.y_axis.majorTickMark = 'out'
        dechart.x_axis.majorTickMark = 'out'
        dechart.title = ''  # 清空图表标题
    
    wb.save(file)
    print(f"已成功处理{len(charts)}个图表")

方案2：处理指定索引范围的图表

如果只需要处理从第二个图表开始的部分图表，可以先判断索引合法性，再切片处理：

def graph_formatting(file, start_index=1, font_style='Times New Roman', fill_color="000000"):
    import openpyxl as opyxl
    from openpyxl.drawing.text import Font, CharacterProperties, RichText, Paragraph, ParagraphProperties

    wb = opyxl.load_workbook(file)
    ws = wb.active
    charts = ws._charts
    
    # 检查索引是否合法
    if len(charts) <= start_index:
        print(f"当前工作表仅包含{len(charts)}个图表，无法从索引{start_index}开始处理")
        return
    
    # 处理从start_index开始的所有图表
    for dechart in charts[start_index:]:
        font_test = Font(typeface=font_style)
        cp = CharacterProperties(latin=font_test, sz=1500)
        dechart.x_axis.txPr = RichText(
                p=[Paragraph(
                     pPr=ParagraphProperties(defRPr=cp), 
                     endParaRPr=cp)
                ])

        dechart.x_axis.graphicalProperties.line.solidFill = fill_color
        dechart.y_axis.graphicalProperties.line.noFill = False
        dechart.y_axis.majorGridlines = None
        dechart.y_axis.majorTickMark = 'out'
        dechart.x_axis.majorTickMark = 'out'
        dechart.title = ''
    
    wb.save(file)
    print(f"已成功处理{len(charts[start_index:])}个图表")

# 调用示例：从第二个图表（索引1）开始处理
graph_formatting("你的Excel文件路径.xlsx", start_index=1)

注意事项 #

• 确保代码中导入了所有需要的类（比如Font、CharacterProperties等，原代码缺失导入语句，运行会报错）
• ws._charts是openpyxl的内部属性，虽然目前稳定可用，但后续版本更新可能存在变动风险
• 处理前建议备份原Excel文件，避免格式设置错误导致数据丢失

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