本文详解 openpyxl 中因合并单元格（MergedCell）导致的 AttributeError: 'MergedCell' object attribute 'value' is read-only 错误成因与解决方案，提供健壮的单元格占用检测逻辑，确保写入前准确跳过已合并或已填充区域。
本文详解 openpyxl 中因合并单元格（mergedcell）导致的 `attributeerror: 'mergedcell' object attribute 'value' is read-only` 错误成因与解决方案，提供健壮的单元格占用检测逻辑，确保写入前准确跳过已合并或已填充区域。
在使用 openpyxl 进行 Excel 表格自动化写入时，若目标区域包含合并单元格（merged cells），直接访问 .value 属性会触发 AttributeError——因为 MergedCell 对象的 value 是只读属性，且其底层不支持赋值操作。原始代码试图通过检查 cell.value is None 判断单元格是否“空闲”，但该逻辑在遇到合并单元格时失效：ws.cell(row, col) 返回的并非普通 Cell，而是 MergedCell 实例，其 .value 无法被读取（或仅返回 None 即使主单元格有值），更无法用于写入。
正确做法是主动识别合并单元格状态，而非依赖 .value 判断。openpyxl 提供了 openpyxl.cell.MergedCell 类型，可通过 isinstance(cell, MergedCell) 精准检测。一旦发现任意目标列范围内存在合并单元格，即可视为该行“已被占用”，从而跳转至下一行。
以下是优化后的健壮写入逻辑（含关键注释）：
from openpyxl import Workbook
from openpyxl.cell import MergedCell
wb = Workbook()
ws = wb.active
# 初始化表头（第1行）
for x in range(1, 20):
ws.cell(row=1, column=x).value = x
# 待写入条目：[内容, 起始列, 结束列]
entries = [["Entry 1", 1, 5], ["Entry 2", 2, 6], ["Entry 3", 3, 7]]
for entry in entries:
target_row = None
# 在第2–4行中查找首个可用行
for count_row in range(2, 5):
is_occupied = False
# 检查该行指定列范围内是否存在合并单元格
for count_col in range(entry[1], entry[2] + 1):
cell = ws.cell(row=count_row, column=count_col)
if isinstance(cell, MergedCell):
is_occupied = True
break
if not is_occupied:
target_row = count_row
break
if target_row is None:
raise RuntimeError(f"无法为 {entry[0]} 找到可用行（第2–4行均被合并单元格占用）")
# 合并目标区域并写入内容（仅向合并区域左上角单元格赋值）
ws.merge_cells(
start_row=target_row,
start_column=entry[1],
end_row=target_row,
end_column=entry[2]
)
ws.cell(row=target_row, column=entry[1]).value = entry[0]
wb.save("Test.xlsx")
关键注意事项：
- ✅ 永远优先检测 MergedCell 类型：这是判断“逻辑占用”的最可靠方式，比检查 .value 更准确（合并单元格的 .value 可能为 None，但实际已参与合并）。
- ✅ 合并后仅向起始单元格赋值：merge_cells() 后，只有 (start_row, start_column) 位置的单元格可安全写入；其他位置将返回 MergedCell 对象，不可赋值。
- ⚠️ 避免循环内重复创建 cell 对象：ws.cell() 调用开销较小，但高频调用仍建议缓存 cell = ws.cell(...) 后复用。
- ? 扩展建议：如需更精确判断“是否已有数据”，可结合 ws.merged_cells 属性遍历所有合并区域，或使用 ws[cell_address].coordinate 获取规范地址进行范围重叠检测。
该方案彻底规避了 MergedCell 的只读限制，使自动化写入逻辑在混合格式（普通单元格+合并单元格）的 Excel 表格中稳定运行。
