使用Openpyxl生成Excel时合并单元格引发格式错误问题

问题场景 #

用Openpyxl写的作业日程表生成脚本，运行时没报错，但生成的schedule.xlsx用Excel打开会提示格式错误，需要恢复工作表。调试发现：硬编码合并单元格的结束行数（比如r1+20）时文件能正常打开，按时间范围动态计算行数合并就会触发问题。

可能原因 #

1. 动态计算的行号无效：比如结束行小于起始行，或是行号算出了非整数（Openpyxl会隐式转换，但Excel不认可这种情况）。
2. 合并范围超出Excel限制：Excel单张工作表最大行数是1048576，要是计算出的结束行超过这个值，就会引发格式异常。
3. 合并范围重叠冲突：多个合并操作的单元格范围有重叠，Excel对合并单元格的规则比Openpyxl更严格，冲突会直接触发格式错误。

排查与解决步骤 #

• 验证动态计算的行号：执行合并前打印并校验行号，确保结束行≥起始行且为正整数，必要时强制转换：

  r1 = 5  # 你的起始行
  calculated_rows = your_time_based_calculation()  # 你的时间范围计算逻辑
  r2 = int(r1 + calculated_rows)  # 强制转成整数
  print(f"待合并范围：行{r1} → 行{r2}")
  
  if r2 < r1:
      # 处理异常情况，比如设为默认值或抛出提示
      r2 = r1 + 1
      print("计算出的结束行无效，已自动修正")
  

• 限制合并范围在Excel有效行内：添加最大行数校验，避免超出Excel的单表行数上限：

  MAX_EXCEL_ROWS = 1048576
  if r2 > MAX_EXCEL_ROWS:
      r2 = MAX_EXCEL_ROWS
      print("合并范围超出Excel最大行数，已自动截断")
  

• 检查合并范围是否重叠：维护已合并范围列表，避免重复或重叠的合并操作：

  merged_ranges = []
  
  def check_overlap(new_start, new_end):
      for s, e in merged_ranges:
          if not (new_end < s or new_start > e):
              return True
      return False
  
  # 执行合并前检查
  if not check_overlap(r1, r2):
      ws.merge_cells(start_row=r1, start_col=1, end_row=r2, end_col=1)
      merged_ranges.append((r1, r2))
  else:
      print(f"合并范围{r1}-{r2}与已有合并重叠，跳过该操作")
  

• 确保工作簿正确保存关闭：显式调用关闭方法，避免文件未完全写入导致损坏：

  wb.save("schedule.xlsx")
  wb.close()
  

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