openpyxlでセルを結合・解除する基本とMergedCellオブジェクトの謎を解明

「Pythonのopenpyxlで複数のセルを結合してみたけど、思うように値を設定できない…」「セルに値を書き込んだはずなのに、なぜか消えてしまう…」

openpyxlを使ったExcel操作で、セルの結合は多くの人が利用する機能ですが、その裏側にある仕組みを理解していないと、このような予期せぬトラブルに見舞われがちです。特に**MergedCellオブジェクト**の存在は、初心者がつまずきやすいポイントです。

この記事では、openpyxlにおけるセルの結合・解除の基本的な操作方法から、値が消える原因である**MergedCellオブジェクトの謎**まで、分かりやすく解き明かしていきます。

はじめに：なぜ結合セルへの書き込みは失敗するのか？
openpyxlでセルを結合・解除する基本操作
1. 複数のセルを結合する worksheet.merge_cells()
2. セルの結合を解除する worksheet.unmerge_cells()
MergedCellオブジェクトの謎を解明
1. マスターセルは「左上」だけ
2. 左上以外はMergedCellオブジェクトに変わる
結合セルへ正しく値を書き込む方法
結合されているか確認する方法
まとめ

はじめに：なぜ結合セルへの書き込みは失敗するのか？

結論から言うと、openpyxlでセルを結合すると、範囲内の左上のセルだけが本当のセルとして残り、それ以外はMergedCellという抜け殻のようなオブジェクトに変わってしまうからです。

この「抜け殻」であるMergedCellに値を書き込もうとしても、そのデータは保存されません。これが、値が消えてしまう現象の正体です。この基本ルールさえ理解すれば、結合セルの操作は決して難しくありません。

openpyxlでセルを結合・解除する基本操作

まずは、セルの結合と解除を実行する基本的なメソッドの使い方をマスターしましょう。

複数のセルを結合する worksheet.merge_cells()

セルを結合するには、worksheet.merge_cells()メソッドを使います。引数には結合したいセルの範囲を 'A2:D4' のような文字列で指定するのが一般的です。

import openpyxl

wb = openpyxl.Workbook()
ws = wb.active
ws.title = "結合セルテスト"

# A2からD4の範囲を結合する
print("A2:D4を結合します。")
ws.merge_cells('A2:D4')

# 結合後、A2に値を書き込む
ws['A2'].value = 'この値は正しく表示される'

wb.save('merged_cell_example.xlsx')

このコードで生成されたExcelファイルを開くと、A2からD4が結合され、指定したテキストが表示されているはずです。

セルの結合を解除する worksheet.unmerge_cells()

一度結合したセルを元に戻すには、worksheet.unmerge_cells()を使います。引数の指定方法は結合時と同じです。

# A2からD4の範囲の結合を解除する
print("A2:D4の結合を解除します。")
ws.unmerge_cells('A2:D4')

wb.save('unmerged_cell_example.xlsx')

MergedCellオブジェクトの謎を解明

ここからが本題です。merge_cells()を実行したとき、セルの内部で何が起きているのかを見ていきましょう。

マスターセルは「左上」だけ

A2:D4の範囲を結合した場合、openpyxlは**A2セル（範囲の左上のセル）**を唯一のマスターセルとして扱います。値、フォント、背景色、罫線といったすべての情報は、このマスターセルに集約して保存されます。

左上以外はMergedCellオブジェクトに変わる

一方、マスターセルであるA2以外のすべてのセル（A3, B2, B3, … D4）は、MergedCellという種類の特殊なオブジェクトに変わります。これらは、もはや独立したセルとしての機能を持たない、いわば「見かけ」だけの存在です。

# A2:D4を結合した状態で、各セルの型を調べてみる
ws.merge_cells('A2:D4')

master_cell = ws['A2']
merged_cell = ws['B3'] # 範囲内の左上以外のセル

print(f'A2 (マスターセル)の型: {type(master_cell)}')
print(f'B3 (結合されたセル)の型: {type(merged_cell)}')

実行結果:

A2 (マスターセル)の型: <class 'openpyxl.cell.cell.Cell'>
B3 (結合されたセル)の型: <class 'openpyxl.cell.cell.MergedCell'>Code language: HTML, XML (xml)

このように、同じ結合範囲内でもオブジェクトの型が全く異なることが、この謎を解くカギです。

結合セルへ正しく値を書き込む方法

結合セルの仕組みが分かれば、正しい書き込み方法は至ってシンプルです。必ず結合範囲の左上のセルをターゲットにして操作しましょう。

from openpyxl.styles import Alignment, Font

wb = openpyxl.Workbook()
ws = wb.active

# B2からC3を結合
ws.merge_cells('B2:C3')

# ターゲットは必ず左上の 'B2'
target_cell = ws['B2']
target_cell.value = "請求書"

# スタイル設定も左上のセルに対して行う
target_cell.alignment = Alignment(horizontal='center', vertical='center')
target_cell.font = Font(bold=True, size=16)

wb.save('invoice_header.xlsx')

このコードを実行すれば、結合されたセルの中央に、スタイルが適用された「請求書」という文字が正しく表示されます。

結合されているか確認する方法

プログラムでセルを扱う際、そのセルが結合されているかを知りたい時があります。その場合は、ワークシートのmerged_cells属性を調べることで判定できます。

# ... (前のコードの続き) ...

# B2が結合セル範囲に含まれるかチェック
if 'B2' in ws.merged_cells:
    print('B2は結合されたセル範囲に含まれています。')

# A1が結合セル範囲に含まれるかチェック
if 'A1' not in ws.merged_cells:
    print('A1は結合されていません。')