- Python で Excel ファイルを読み込んだり、書き込んだりしたい
- openpyxl と win32com のどちらを使えばいいか迷っている
- 数式の値が None になる、大きなファイルでメモリが足りない、といった問題で困っている
僕は、Excel のデータを読み書きするとき、書式(装飾)が崩れてもかまわない場面では openpyxl を使っています。体感で速いですし、OS に関係なく、Excel がインストールされていない Mac や Linux でも同じコードで動くからです。
この記事では、openpyxl でブックを作る・読む・書き換える・複数シートを扱う・数式を扱う・大きなファイルを扱う、という基本を、実際に動かしたコードと出力つきでまとめます。あわせて、win32com との使い分けと、openpyxl で保存し直したときに何が残り何が消えるかを、確かめた範囲で書きます。
- macOS 27.2(Apple シリコン)
- Python 3.12.16
- openpyxl 3.1.5(uv で追加)
- Excel 本体は使っていません。保存したファイルは openpyxl で読み直して確かめています
openpyxl と win32com の使い分け
Python から Excel を扱う方法として、openpyxl のほかに win32com(pywin32)があります。win32com は Excel 本体を Python から操作する方法で、こちらの記事で詳しく紹介しています。
僕の使い分け
| openpyxl | win32com | |
|---|---|---|
| 必要なもの | Python と openpyxl だけ | Windows と Excel 本体 |
| 動く OS | Windows・Mac・Linux | Windows のみ |
| しくみ | xlsx ファイルを直接読み書きする | Excel を起動して操作する |
| 向いている作業 | データの読み書き、集計結果の書き出し | 書式やマクロを保ったまま編集したいとき |
僕は、装飾が壊れてもいいときは openpyxl を使います。「中身のデータだけ取り出したい」「集計結果を新しいファイルに書き出したい」なら openpyxl、「会社で使っている書式付きのテンプレートやマクロを崩さずに書き込みたい」なら、Windows と Excel 本体が要りますが win32com、という使い分けです。
openpyxl で開いて保存し直したときに残ったもの・消えたもの
openpyxl はファイルを読み込んで自分の形に置き換え、保存するときに書き直します。そのため、openpyxl が扱えないものは保存し直すと消えることがあります。今回は次の2つを確かめました。
- openpyxl で装飾・グラフ付きのブックを作り、それを開いて保存し直す
- マクロの部品(
xl/vbaProject.bin)を入れたテスト用の .xlsm を、開いて保存し直す
| 確かめたもの | 結果 |
|---|---|
| 文字の太字・塗りつぶし・列幅 | 残った |
| セルの結合・コメント・ウィンドウ枠の固定 | 残った |
| 入力規則・条件付き書式 | 残った |
| openpyxl で作った棒グラフ | 残った |
| マクロの部品(そのまま開いて保存) | 消えた |
マクロの部品(keep_vba=True で開いて .xlsm で保存) | 残った |
マクロの部品(keep_vba=True なしで開いて .xlsx で保存) | 消えた |
マクロの確認に使ったのは、Excel で作ったマクロではなく、中身がダミーの部品を入れたテスト用ファイルです。そのため「マクロが Excel で動くか」までは確かめていません。マクロ付きのファイルを openpyxl で扱うときは、少なくとも load_workbook("ファイル.xlsm", keep_vba=True) で開き、.xlsm で保存してください。
今回の環境には Excel がないため、Excel で作った画像・グラフ・図形が openpyxl で保存し直したあとにどうなるかは確かめていません。上の表で残ったのは openpyxl 自身が作ったグラフです。win32com の記事で書いた「openpyxl で保存したらグラフが消えた」は Excel で作ったグラフの話で、その対処も win32com の記事で扱っています。大事なファイルは、上書きせず別名で保存して中身を確かめるのがおすすめです。
openpyxl をインストールする
uv で追加する
僕は uv でプロジェクトを管理しているので、uv add で追加しました。
uv add openpyxlResolved 3 packages in 2ms
Installed 2 packages in 4ms
+ et-xmlfile==2.0.0
+ openpyxl==3.1.5pip を使っている場合は pip install openpyxl で入ります。この記事のスクリプトは、どれも uv run python ファイル名.py で実行しています。
バージョンを確認する
uv run python -c "import sys, openpyxl; print(sys.version.split()[0], openpyxl.__version__)"3.12.16 3.1.5Excel ファイルを新しく作る
Workbook でブックを作ってセルに書く
新しいブックは Workbook() で作ります。最初から1枚のシートがあり、wb.active で取り出せます。
from datetime import date
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.title = "売上"
# 1行目に見出しを書く
ws["A1"] = "日付"
ws["B1"] = "商品"
ws["C1"] = "数量"
ws["D1"] = "単価"
# 行をまとめて追加する
ws.append([date(2026, 11, 1), "りんご", 3, 120])
ws.append([date(2026, 11, 2), "みかん", 5, 80])
ws.append([date(2026, 11, 3), "ぶどう", 1, 450])
# 行・列の番号で書く(1始まり)
ws.cell(row=5, column=2, value="合計")
wb.save("sales.xlsx")
print("保存しました:", ws.max_row, "行", ws.max_column, "列")保存しました: 5 行 4 列sales.xlsx ができました。ポイントは次の3つです。
| 書き方 | 意味 |
|---|---|
ws["A1"] = "日付" | セル番地を指定して書く |
ws.append([...]) | いちばん下の行の次に、1行まとめて追加する |
ws.cell(row=5, column=2, value=...) | 行と列の番号で書く(どちらも1始まり) |
日付はそのまま渡す
datetime.date の値はそのまま書き込めます。あとで読み込むと datetime.datetime として返ってきました(次の章の出力を見てください)。
Excel ファイルを読み込む
load_workbook でシートとセルを読む
既存のファイルは load_workbook() で開きます。先ほどの sales.xlsx を読みます。
from openpyxl import load_workbook
wb = load_workbook("sales.xlsx")
print(wb.sheetnames)
ws = wb["売上"]
print(ws["B2"].value)
print(ws.cell(row=2, column=3).value)
print(repr(ws["A2"].value))
print(ws.max_row, ws.max_column, ws.dimensions)
# 2行目から最終行まで、値だけを取り出す
for row in ws.iter_rows(min_row=2, values_only=True):
print(row)['売上']
りんご
3
datetime.datetime(2026, 11, 1, 0, 0)
5 4 A1:D5
(datetime.datetime(2026, 11, 1, 0, 0), 'りんご', 3, 120)
(datetime.datetime(2026, 11, 2, 0, 0), 'みかん', 5, 80)
(datetime.datetime(2026, 11, 3, 0, 0), 'ぶどう', 1, 450)
(None, '合計', None, None)wb.sheetnames でシート名の一覧、wb["売上"] でシートを取り出します。セルの値は .value で読みます。
iter_rows で表を1行ずつ読む
iter_rows(values_only=True) を使うと、1行ずつ値のタプルで受け取れます。min_row=2 で見出しの行を飛ばしています。空のセルは None になります。
表のデータを集計したり並べ替えたりしたいなら、pandas で読み込むほうが楽なこともあります。pandas の基本はこちらの記事にまとめています。
max_row は「セルが作られた最後の行」
ws.max_row と ws.max_column は、値や書式が入った(作られた)セルの最後の行・列です。今回は5行目に「合計」とだけ書いたので、max_row は 5、ws.dimensions は A1:D5 になりました。
値が入っていなくても伸びることがあります。2行だけ書いたシートで試しました。
from openpyxl import Workbook
from openpyxl.styles import Font
wb = Workbook()
ws = wb.active
ws.append(["日付", "商品"])
ws.append(["2026-11-01", "りんご"])
print("書いた直後:", ws.max_row, ws.dimensions)
ws["A10"].font = Font(bold=True) # 値は入れず書式だけ
print("A10 に書式だけ:", ws.max_row, ws.dimensions)
print(ws["B20"].value) # 読むために参照しただけ
print("B20 を参照しただけ:", ws.max_row, ws.dimensions)書いた直後: 2 A1:B2
A10 に書式だけ: 10 A1:B10
None
B20 を参照しただけ: 20 A1:B20書式だけを付けたセルや、値を読むために ws["B20"] と参照しただけの空のセルも、その時点で作られて max_row が伸びました。表の下にメモがある場合も含まれるので、データの最後の行を知りたいときは、値が入っているかを自分で確かめるほうが確実です。
既存のファイルを書き換えて保存する
セルを書き換えて行を挿入する
読み込んだブックのセルに値を入れ、save() すれば書き換えられます。insert_rows(5) は、5行目の位置に空の行を1行入れます。
from datetime import date
from openpyxl import load_workbook
wb = load_workbook("sales.xlsx")
ws = wb["売上"]
ws["C3"] = 6 # みかんの数量を直す
ws.insert_rows(5) # 「合計」の行の上に1行空ける
ws["A5"] = date(2026, 11, 4)
ws["B5"] = "もも"
ws["C5"] = 2
ws["D5"] = 300
wb.save("sales_updated.xlsx")
for row in load_workbook("sales_updated.xlsx")["売上"].iter_rows(values_only=True):
print(row)('日付', '商品', '数量', '単価')
(datetime.datetime(2026, 11, 1, 0, 0), 'りんご', 3, 120)
(datetime.datetime(2026, 11, 2, 0, 0), 'みかん', 6, 80)
(datetime.datetime(2026, 11, 3, 0, 0), 'ぶどう', 1, 450)
(datetime.datetime(2026, 11, 4, 0, 0), 'もも', 2, 300)
(None, '合計', None, None)みかんの数量が 6 になり、「合計」の行が6行目に下がって、空いた5行目に「もも」が入りました。
保存先は元のファイルと別名にしておく
save() に元と同じファイル名を渡すと、確認なしで上書きされます。前の章のとおり、openpyxl で保存し直すと消えるものもあるので、慣れるまでは別名で保存して中身を確かめてから差し替えると安心です。
複数のシートを扱う
シートの追加・コピー・削除
from openpyxl import load_workbook
wb = load_workbook("sales.xlsx")
summary = wb.create_sheet("集計") # 末尾に追加
memo = wb.create_sheet("メモ", 0) # 先頭に追加
print(wb.sheetnames)
copied = wb.copy_worksheet(wb["売上"]) # 同じブックの中でコピー
copied.title = "売上_控え"
print(wb.sheetnames)
wb.remove(wb["メモ"])
print(wb.sheetnames)
# すべてのシートを順に見る
for ws in wb.worksheets:
print(ws.title, ws.max_row)
wb.active = wb.sheetnames.index("集計") # 開いたときに表示するシート
wb.save("sales_sheets.xlsx")
print("active:", load_workbook("sales_sheets.xlsx").active.title)['メモ', '売上', '集計']
['メモ', '売上', '集計', '売上_控え']
['売上', '集計', '売上_控え']
売上 5
集計 1
売上_控え 5
active: 集計| 書き方 | やること |
|---|---|
wb.create_sheet("集計") | 末尾にシートを追加する |
wb.create_sheet("メモ", 0) | 指定した位置(0 は先頭)に追加する |
wb.copy_worksheet(ws) | 同じブックの中でシートをコピーする |
wb.remove(ws) | シートを削除する |
wb.worksheets | すべてのシートを順に取り出す |
開いたときに表示するシートを決める
wb.active にシートの番号を入れると、Excel で開いたときに最初に表示されるシートを決められます。保存して読み直すと、active が「集計」になっていました。新しいシートは中身が空なので、max_row は 1 です。
数式の扱い(data_only)
数式は文字列として書き込む
セルに = から始まる文字列を入れると、数式として保存されます。読み込むときの data_only の違いも一緒に確かめました。
from openpyxl import load_workbook
wb = load_workbook("sales.xlsx")
ws = wb["売上"]
for r in range(2, 5):
ws[f"E{r}"] = f"=C{r}*D{r}" # 金額 = 数量 × 単価
ws["E1"] = "金額"
ws["E5"] = "=SUM(E2:E4)"
wb.save("sales_formula.xlsx")
# そのまま読むと、数式の文字列が返る
ws = load_workbook("sales_formula.xlsx")["売上"]
print("通常:", ws["E2"].value, ws["E5"].value)
# data_only=True は「最後に計算された値」を読む
ws = load_workbook("sales_formula.xlsx", data_only=True)["売上"]
print("data_only:", ws["E2"].value, ws["E5"].value)
# data_only=True で開いたまま保存すると、数式はどうなるか
load_workbook("sales_formula.xlsx", data_only=True).save("sales_formula_dataonly.xlsx")
ws = load_workbook("sales_formula_dataonly.xlsx")["売上"]
print("data_only で保存後:", ws["E2"].value, ws["E5"].value)通常: =C2*D2 =SUM(E2:E4)
data_only: None None
data_only で保存後: None Nonedata_only=True で None になる理由
ふつうに読み込むと、数式の文字列(=C2*D2)がそのまま返ります。data_only=True は数式ではなく「最後に計算された値」を読む指定ですが、今回は None になりました。
openpyxl は数式を計算しません。計算結果はふつう Excel がファイルを保存するときに一緒に書き込むもので、openpyxl で書いただけのファイルにはまだ計算結果が入っていないためです。計算結果が必要なら、Python 側で計算して値として書き込むのが確実です。
最後の行のとおり、data_only=True で開いたブックを保存すると、読み直しても数式は残っていませんでした(今回は計算結果もなかったので None)。値を読むためのブックと、書き換えて保存するためのブックは分けて開きましょう。
大きなファイルは read_only / write_only で扱う
10万行で比べた結果
10万行×5列のデータで、ふつうのモードと write_only・read_only を比べました。時間は1回ずつ測り、メモリは Python の tracemalloc で測った最大値です。
"""通常モードと write_only / read_only の時間・メモリを比べる(10万行×5列)。"""
import time
import tracemalloc
from pathlib import Path
from openpyxl import Workbook, load_workbook
N = 100_000
def measure(label, func):
# 時間は tracemalloc なしで測る(tracemalloc を付けると遅くなるため)
t = time.perf_counter()
result = func()
sec = time.perf_counter() - t
# メモリは別にもう一度動かして、Python が確保した量の最大値を見る
tracemalloc.start()
func()
peak = tracemalloc.get_traced_memory()[1] / 1024 / 1024
tracemalloc.stop()
print(f"{label}: {sec:.2f} 秒 / 最大 {peak:.1f} MB / {result}")
def write_normal():
wb = Workbook()
ws = wb.active
for i in range(N):
ws.append([i, f"name{i}", i * 2, i * 3, i * 4])
wb.save("big_normal.xlsx")
return f"{Path('big_normal.xlsx').stat().st_size / 1024 / 1024:.1f} MB"
def write_only():
wb = Workbook(write_only=True)
ws = wb.create_sheet()
for i in range(N):
ws.append([i, f"name{i}", i * 2, i * 3, i * 4])
wb.save("big_write_only.xlsx")
return f"{Path('big_write_only.xlsx').stat().st_size / 1024 / 1024:.1f} MB"
def read_normal():
wb = load_workbook("big_write_only.xlsx")
ws = wb.active
return sum(row[2] for row in ws.iter_rows(values_only=True))
def read_only():
wb = load_workbook("big_write_only.xlsx", read_only=True)
ws = wb.active
total = sum(row[2] for row in ws.iter_rows(values_only=True))
wb.close()
return total
measure("書き込み(通常)", write_normal)
measure("書き込み(write_only)", write_only)
measure("読み込み(通常)", read_normal)
measure("読み込み(read_only)", read_only)| 処理 | 時間 | メモリの最大値 |
|---|---|---|
| 書き込み(通常) | 1.95 秒 | 164.3 MB |
書き込み(write_only=True) | 1.62 秒 | 0.4 MB |
| 読み込み(通常) | 1.78 秒 | 188.2 MB |
読み込み(read_only=True) | 1.65 秒 | 8.5 MB |
時間の差は小さかったのですが、メモリは大きく減りました。ふつうのモードは全部のセルをメモリに持つので、行が増えるほどメモリを使います。大きなファイルでメモリが足りなくなるときは、この2つのモードを試してください。
read_only の使い方と注意点
wb = load_workbook("big.xlsx", read_only=True)
ws = wb.active
for row in ws.iter_rows(values_only=True):
...
wb.close()read_only=True で開いたシートには書き込めません。試すと次のエラーになりました。また、読み終わったら wb.close() でファイルを閉じます。
TypeError: 'ReadOnlyWorksheet' object does not support item assignmentwrite_only の使い方と注意点
wb = Workbook(write_only=True)
ws = wb.create_sheet()
for row in rows:
ws.append(row)
wb.save("big.xlsx")write_only=True のブックは、確かめたところ次のような制限がありました。
| やったこと | 結果 |
|---|---|
wb.active | None(最初はシートがないので create_sheet() で作る) |
ws["A1"] = "x" | TypeError: 'WriteOnlyWorksheet' object does not support item assignment |
同じブックを2回 save() | 2回目は FileNotFoundError になった |
書き込めるのは append() で上から順に1行ずつだけで、保存も1回きりです。全部の行を作り終えてから最後に1回だけ保存します。
よくあるエラー
CSV は load_workbook で開けない
load_workbook() で CSV ファイルを開こうとすると、次のエラーになりました。
InvalidFileException: openpyxl does not support .csv file format, please check you can open it with Excel first. Supported formats are: .xlsx,.xlsm,.xltx,.xltmメッセージのとおり、openpyxl が扱えるのは .xlsx・.xlsm・.xltx・.xltm です。CSV は Python の csv モジュールや pandas で読み込みます。古い形式の .xls もこの対応形式の一覧にはありません(.xls は今回試していません)。
ファイルが見つからない(FileNotFoundError)
FileNotFoundError: [Errno 2] No such file or directory: 'nothing.xlsx'ファイル名は、スクリプトを実行したフォルダ(カレントディレクトリ)からの相対パスとして探されます。スクリプトと同じフォルダのファイルを開きたいときは、pathlib で Path(__file__).parent / "sales.xlsx" のように組み立てると確実です。
まとめ
openpyxl でよく使う書き方をまとめます。
- 作る:
Workbook()→ws.append()/ws["A1"] = ...→wb.save() - 読む:
load_workbook()→ws.iter_rows(values_only=True) - シート:
create_sheet()・copy_worksheet()・remove() - 数式:openpyxl は計算しない。
data_only=Trueで開いたブックは保存しない - 大きなファイル:
read_only=True/write_only=Trueでメモリを減らす
書式やマクロをそのまま保ちたいファイルは、Excel 本体を操作する win32com のほうが向いています。データの読み書きが中心なら、どの OS でも動く openpyxl から始めてみてください。
