当前位置：首页 > news >正文

Python 使用 Tkinter + openpyxl 处理 Excel 文件并显示实时进度条

news 2026/5/12 0:33:27

在项目开发或数据处理中，经常需要批量处理 Excel 文件，例如将所有单元格的值强制转换为字符串（特别是处理合并单元格时，避免读取到None）。如果文件行数较多，处理时间较长，用户很容易误以为程序卡死。这时，添加一个实时进度条就能极大提升用户体验。

本文分享一个完整示例：使用openpyxl正确处理合并单元格并将单元格转为字符串，同时结合Tkinter实现带进度条的图形界面，实时显示处理进度、当前工作表和已处理行数。

环境准备

pipinstallopenpyxl

Tkinter是 Python 标准库，无需额外安装。

完整代码

importtkinterastkfromtkinterimportttkimportopenpyxldefupdate_progress(progress_var,processed,total):"""更新进度条百分比"""iftotal>0:progress=(processed/total)*100progress_var.set(progress)defprocess_sheet(sheet,progress_var,root,progress_label,accumulated_rows,total_all_rows):""" 处理单个工作表 正确处理合并单元格，将所有单元格值转换为字符串 """current_processed=0# 当前工作表已处理行数forrowinsheet.iter_rows():forcellinrow:# 判断是否在合并单元格内ifcell.coordinateinsheet.merged_cells:# 查找对应的合并区域，取出左上角单元格的值formerged_rangeinsheet.merged_cells.ranges:ifcell.coordinateinmerged_range:top_left=sheet.cell(merged_range.min_row,merged_range.min_col)value=top_left.valuebreakelse:value=cell.value# 统一转为字符串，None 转为空字符串cell.value=str(value)ifvalueisnotNoneelse''current_processed+=1total_processed=accumulated_rows+current_processed# 更新进度条和文字update_progress(progress_var,total_processed,total_all_rows)progress_label.config(text=f"正在处理工作表：{sheet.title}"f"进度：{progress_var.get():.2f}% "f"已处理行数：{total_processed}/{total_all_rows}")root.update_idletasks()# 强制刷新界面returnaccumulated_rows+current_processedif__name__=="__main__":# 请修改为你的实际 Excel 文件路径file_path="output_file.xlsx"workbook=openpyxl.load_workbook(file_path)# 计算所有工作表的总行数，用于整体进度显示total_all_rows=sum(sheet.max_rowforsheetinworkbook.worksheets)# 创建主窗口root=tk.Tk()root.title("Excel 单元格转字符串工具（带进度条）")root.geometry("600x200")root.resizable(False,False)# 进度变量progress_var=tk.DoubleVar(value=0)# 标题title_label=tk.Label(root,text="正在处理 Excel 文件，请稍候...",font=("微软雅黑",12))title_label.pack(pady=20)# 进度条progress_bar=ttk.Progressbar(root,mode="determinate",variable=progress_var,maximum=100)progress_bar.pack(padx=50,pady=10,fill=tk.X)# 进度文字progress_label=tk.Label(root,text="进度：0.00% 已处理行数：0/0",font=("微软雅黑",10))progress_label.pack(pady=5)accumulated_rows=0# 已累计处理行数# 逐个处理工作表forsheet_nameinworkbook.sheetnames:sheet=workbook[sheet_name]accumulated_rows=process_sheet(sheet,progress_var,root,progress_label,accumulated_rows,total_all_rows)# 处理完成progress_var.set(100)title_label.config(text="所有工作表处理完成！")progress_label.config(text=f"处理完成！100.00% 总计处理行数：{total_all_rows}/{total_all_rows}")# 保存文件workbook.save(file_path)print(f"处理完成，文件已保存：{file_path}")# 保持窗口打开，直到用户手动关闭root.mainloop()

核心功能详解

合并单元格正确处理
合并区域内除左上角外的单元格读取时会返回None，代码通过遍历merged_cells.ranges找到对应区域的左上角值，确保数据不丢失。
实时进度条
每处理完一行就调用root.update_idletasks()强制刷新界面，让进度条和文字实时更新，视觉反馈流畅。
多工作表整体进度
预先统计所有 sheet 的总行数，实现整个文件的统一进度显示，同时显示当前正在处理的工作表名称。