openpyxlの使い方|PythonでExcelを読み込み・書き込みする基本

  • Python で Excel ファイルを読み込んだり、書き込んだりしたい
  • openpyxl と win32com のどちらを使えばいいか迷っている
  • 数式の値が None になる、大きなファイルでメモリが足りない、といった問題で困っている

僕は、Excel のデータを読み書きするとき、書式(装飾)が崩れてもかまわない場面では openpyxl を使っています。体感で速いですし、OS に関係なく、Excel がインストールされていない Mac や Linux でも同じコードで動くからです。

この記事では、openpyxl でブックを作る・読む・書き換える・複数シートを扱う・数式を扱う・大きなファイルを扱う、という基本を、実際に動かしたコードと出力つきでまとめます。あわせて、win32com との使い分けと、openpyxl で保存し直したときに何が残り何が消えるかを、確かめた範囲で書きます。

この記事で動かした環境(2026年11月18日)
  • 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 から操作する方法で、こちらの記事で詳しく紹介しています。

僕の使い分け

openpyxlwin32com
必要なものPython と openpyxl だけWindows と Excel 本体
動く OSWindows・Mac・LinuxWindows のみ
しくみ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 で保存)消えた
openpyxl 3.1.5 で確認(2026年11月18日)

マクロの確認に使ったのは、Excel で作ったマクロではなく、中身がダミーの部品を入れたテスト用ファイルです。そのため「マクロが Excel で動くか」までは確かめていません。マクロ付きのファイルを openpyxl で扱うときは、少なくとも load_workbook("ファイル.xlsm", keep_vba=True) で開き、.xlsm で保存してください。

注意:Excel で作った画像・グラフ・図形は今回確かめていない

今回の環境には Excel がないため、Excel で作った画像・グラフ・図形が openpyxl で保存し直したあとにどうなるかは確かめていません。上の表で残ったのは openpyxl 自身が作ったグラフです。win32com の記事で書いた「openpyxl で保存したらグラフが消えた」は Excel で作ったグラフの話で、その対処も win32com の記事で扱っています。大事なファイルは、上書きせず別名で保存して中身を確かめるのがおすすめです。

openpyxl をインストールする

uv で追加する

僕は uv でプロジェクトを管理しているので、uv add で追加しました。

Bash
uv add openpyxl
Text
Resolved 3 packages in 2ms
Installed 2 packages in 4ms
 + et-xmlfile==2.0.0
 + openpyxl==3.1.5

pip を使っている場合は pip install openpyxl で入ります。この記事のスクリプトは、どれも uv run python ファイル名.py で実行しています。

バージョンを確認する

Bash
uv run python -c "import sys, openpyxl; print(sys.version.split()[0], openpyxl.__version__)"
Text
3.12.16 3.1.5

Excel ファイルを新しく作る

Workbook でブックを作ってセルに書く

新しいブックは Workbook() で作ります。最初から1枚のシートがあり、wb.active で取り出せます。

Python
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, "列")
Text
保存しました: 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 を読みます。

Python
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)
Text
['売上']
りんご
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行だけ書いたシートで試しました。

Python
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)
Text
書いた直後: 2 A1:B2
A10 に書式だけ: 10 A1:B10
None
B20 を参照しただけ: 20 A1:B20

書式だけを付けたセルや、値を読むために ws["B20"] と参照しただけの空のセルも、その時点で作られて max_row が伸びました。表の下にメモがある場合も含まれるので、データの最後の行を知りたいときは、値が入っているかを自分で確かめるほうが確実です。

既存のファイルを書き換えて保存する

セルを書き換えて行を挿入する

読み込んだブックのセルに値を入れ、save() すれば書き換えられます。insert_rows(5) は、5行目の位置に空の行を1行入れます。

Python
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)
Text
('日付', '商品', '数量', '単価')
(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 で保存し直すと消えるものもあるので、慣れるまでは別名で保存して中身を確かめてから差し替えると安心です。

複数のシートを扱う

シートの追加・コピー・削除

Python
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)
Text
['メモ', '売上', '集計']
['メモ', '売上', '集計', '売上_控え']
['売上', '集計', '売上_控え']
売上 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 の違いも一緒に確かめました。

Python
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)
Text
通常: =C2*D2 =SUM(E2:E4)
data_only: None None
data_only で保存後: None None

data_only=True で None になる理由

ふつうに読み込むと、数式の文字列(=C2*D2)がそのまま返ります。data_only=True は数式ではなく「最後に計算された値」を読む指定ですが、今回は None になりました。

openpyxl は数式を計算しません。計算結果はふつう Excel がファイルを保存するときに一緒に書き込むもので、openpyxl で書いただけのファイルにはまだ計算結果が入っていないためです。計算結果が必要なら、Python 側で計算して値として書き込むのが確実です。

注意:data_only=True で開いて保存すると数式が消える

最後の行のとおり、data_only=True で開いたブックを保存すると、読み直しても数式は残っていませんでした(今回は計算結果もなかったので None)。値を読むためのブックと、書き換えて保存するためのブックは分けて開きましょう。

大きなファイルは read_only / write_only で扱う

10万行で比べた結果

10万行×5列のデータで、ふつうのモードと write_only・read_only を比べました。時間は1回ずつ測り、メモリは Python の tracemalloc で測った最大値です。

Python
"""通常モードと 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
10万行×5列、できたファイルはどちらも約3.0MB(macOS・Apple シリコン、2026年11月18日)

時間の差は小さかったのですが、メモリは大きく減りました。ふつうのモードは全部のセルをメモリに持つので、行が増えるほどメモリを使います。大きなファイルでメモリが足りなくなるときは、この2つのモードを試してください。

read_only の使い方と注意点

Python
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() でファイルを閉じます。

Text
TypeError: 'ReadOnlyWorksheet' object does not support item assignment

write_only の使い方と注意点

Python
wb = Workbook(write_only=True)
ws = wb.create_sheet()
for row in rows:
    ws.append(row)
wb.save("big.xlsx")

write_only=True のブックは、確かめたところ次のような制限がありました。

やったこと結果
wb.activeNone(最初はシートがないので 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 ファイルを開こうとすると、次のエラーになりました。

Text
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)

Text
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 から始めてみてください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

普段は主にPython開発をしています。
最近はAI駆動開発にも関わっています。